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□ ccording to some visionaries, Windows is the only interface worth a 
developer’s time when creating new software. Even the Software 
Publisher’s Association (SPA), which compares the sales of charac¬ 
ter-based (DOS) software to graphically-based (Windows) software, says 
DOS is losing hegemony in the marketplace. 

In the first half of 1992, the SPA reports, character-based software sales 
tumbled from $1.41 billion to $1.29 billion. In a comparable time period, 
sales of new Windows software grew from $355 million to $857 million. 

These numbers are revealing, but they don’t tell me that DOS is on the 
ropes. No matter how good a selling job Microsoft is doing for its doohickey- 
and-button interface, Windows is neither as widespread as DOS among PC 
owners, nor is it, necessarily, assured of a place in the future. 

The total market for PC and Macintosh software sales in the first half of 
1992 was $2.74 billion—an increase of nearly $500 million over the first 
half of 1991—and that growth comes during a business recession. This ex¬ 
panded market is something prognosticators missed. Increases in sales of 
Windows software no doubt came at the the expense of some sales of DOS 
software, but overall growth in the entire PC software marketplace sug¬ 
gests that Windows-ready computers are opening up the market for both 
types of software, not disenfranchising DOS. 

In fact, a slowdown in the sales of character-based programs at the be¬ 
ginning of the year may have much more to do with a general slump in 
sales of goods to business than with an erosion of confidence in character- 
based software. 

Then there’s the issue of PC makers that are bundling Windows with 
their new systems. Though this habit may explain the steep growth curve 
in new Windows software, it also points up some flaws in judging the size 
of a market in retail dollars alone. 

SPA figures, measured in dollars, do not take into consideration the 
number of software units sold, nor do they factor in the sizable—but un¬ 
measurable—hidden market in shareware products sold for DOS. (At this 
point, sales of Window’s shareware are less significant.) Consider, too, the 
lower price—compared to Windows software—of new DOS software. Also 
consider that many sales of DOS software are for inexpensive upgrades. It 
takes a lot of upgrades to generate a billion dollars in revenue. 

When you consider all the facts, I find ample evidence to suggest the 
DOS software market is alive and well—and that it will be for quite some 
time. As Windows owners acquire the necessary software to outfit their 
computers, I’m betting that we are likely to see developers facing the reali¬ 
ty of Window’s’ market share. With just 10 million copies of Windows sold 
( not all of which are in use), software vendors may yet ease off their invest¬ 
ment in Windows programming and return their development dollars to 
DOS, of which more than 50 million copies have been sold. 


■=■ JI 'NZ' ^ DOS Resource Guide is a 
publication of International 
Data Group, the world’s leader in information 
services on information technology. 
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These 35 setup tips prove Windows isn’t yet the operating system for the rest of us. 

by Kay Yarborough Nelson 
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EDITOR 


A Breakthrough 

Recently I purchased DOS 
Resource Guide and was so pleased 
with it that I had to write you 
about it. I became a PC owner back 
in December, and learning about 
DOS, programming, and so on has 
been very challenging for me. 
Finding your magazine, however, 
and discovering it to be a treasure 
trove of information I can under¬ 
stand is mind bending. 

I copied SETSCRN.BAS and also 
SAVER.BAS ( u Color Trouble," Tips 
From Readers, DRG# 5, page 7) 
sent in by David Ferrier, and they 
work. That’s a First for me. I’ve 
tried copying other small pro¬ 
grams, but either I always did 
something wrong and did not un¬ 
derstand the instructions or there 


were typos in the articles. These 
two programs worked without a 
hitch. Again, thank you for your 
truly informative publication. 

Beverly Stoddard 
Coram, N.Y. 


Not for Beginners Only 

Yesterday I purchased my first is¬ 
sue of your magazine (DRG# 5). I 
think you’ve put together an excel¬ 
lent guide for both novice and ex¬ 
perienced DOS users. I consider 
myself advanced but was happily 
surprised to Find a couple of tips 
and tricks 1 was unaware of. I plan 
to put them to immediate use. 

Thank you for a job well done. 

Brian Baker 
Nashua, N IL 


Kudos from Canada 

I’m a faithful reader of your maga¬ 
zine and am pleased to hear it is 
now available through subscrip¬ 
tion. It has been a great help to me. 
The articles are detailed and writ¬ 
ten in language a novice can un¬ 
derstand. I have read many books 
and manuals on DOS, but none is 
as good as DOS Resource Guide. 

Donna Heftyzer 
Regina, Saskatchewan 

Defending the “Worst” 

In a rack of computer magazines, 
DRG#5 stood out. It looks like an 
excellent magazine for DOS begin¬ 
ners. 

However, I was disappointed in 
the article “10 Worst DOS com¬ 
mands" (page 23) by Dan Gookin. 
First, he says, “Edlin is awkward 
and ugly”; however, if you are sit¬ 
ting in front of an almost dead 
computer with serious software 
problems, Edlin is a godsend that 
can help you get the computer back 
into working condition. (DOS 5.0’s 
Edit is nice, but have you ever 
tried to run it on a computer with 
memory allocation problems or on 
one without DOS 5.0?) 

Second, he says that the imple¬ 
mentation of CHOP, NLSFUNC, 
MODE, and other related com¬ 
mands stinks. But without the 
MODE command, you could never 
write a batch file to dial a modem, 
for example. 

Third, he writes that “CTTY... is 
fun to demonstrate but impracti¬ 
cal.” Well, this “impractical” com¬ 
mand is a big part of the security 
for my laptop. Once I had my AU¬ 
TOEXEC.BAT file working correct¬ 
ly, I added CTTY NUL as the very 
first line and inserted CTTY CON in 
the line above the one that exe¬ 
cutes a menu program with its owm 
security. This stops all snoopers 


Let Us Hear From You 

DOS Resource Guide wants to know about your 
computing trials and tribulations. The editors 
welcome your correspondence and encourage you 
to share your DOS tips or criticize ours. 

From among the letters and batch files we 
receive, the editors will choose a “Best of the 
Batch” selection that could earn you $50 and a 
published credit. 

So whether you work as a network admin¬ 
istrator, a high school teacher, or just hang out at 
the command prompt, you have something to 
share with DOS Resource Guide readers. Send 
your criticism, your praise, and your best batch 
files to: 

DOS Resource Guide 

80 Elm St 

Peterborough, NH 03458 

or reach us through CompuServe: 75300,2361 
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from pressing Ctrl-Break or Ctrl-C 
to interrupt AUTOEXEC.BAT be¬ 
fore it loads the security program. 

It seems to me that in a magazine 
that is a DOS “resource” guide, 
maybe time would be better spent 
on an article that provides tips and 
secrets for using some of these so- 
called worst commands. 

Kevin Alexander 
Cambridge, Ontario 

A Bone to Pick 

Curiosity prompts me to pick up 
your magazine at a local bookstore 
whenever a new* issue is out. I find 
it interesting and well written for 
relative novices (such as myself) 
who are fascinated with the topics it 
covers and a little timid about try¬ 
ing to put its suggestions into prac¬ 
tice on our systems. 

However, I have a bone to pick. 
Like many publications, yours uses 
the term DOS as if it referred exclu¬ 
sively to Microsoft's MS-DOS, mak¬ 
ing little mention, if any, of other 
types of operating systems. 

I recently upgraded from MS- 
DOS 3.2 to DR DOS 6.0 to maintain 
continuity with my GEM metafile 
system and explore the newer (for 
me) frontiers of PC computer tech¬ 
nology. I wish that in keeping with 
your generic title— DOS Resource 
Guide , The PC Productivity Mag¬ 
azine—you w r ould provide more in¬ 
formation on DR DOS (and, pre¬ 
sumably, other operating systems). 

I enjoy your publication even 
though I have to try to figure out 
what implications its articles may 
have for DR DOS users. 

Gordon Kearns 
Burlington , Ontario 

See “DR DOS 6.0: A Most Worthy 
Opponent ” in DRG #6, page 51, for 
an overview of that operating system . 

—Eds. 


Long-Time DOS User 

I bought an issue of DOS Resource 
Guide when I dodged into a book¬ 
shop to escape the rain. Imagine my 
delight: all my friends from PC 
Resource. I am a long-time PC user, 
and although I own some published 
programs, the 10 or so applications I 
use are my own. All are written in 
my own modular version of Basic. 
Please continue to include some ma¬ 
terial on that language. I have be¬ 
come completely disgusted with all 
the other computer magazines. They 
contain nothing but reviews of com¬ 
mercial programs—not a single arti¬ 
cle of interest to someone like me. 

Keep up the good stuff. 

M.O. Kappler 
San Pedro, Calif. 

A Good Investment 

I have worked with computers for 
seven years. I’m very knowledge¬ 
able about each program I teach, 
but I have no technical background. 
My level of proficiency with DOS is 
intermediate, and I am striving to 
reach an advanced level. Your mag¬ 
azine is the best investment I have 
made in a long time. I thank my as¬ 
sociates for telling me about it and 
would highly recommend it to all 
levels of DOS users. Your writing 
staff has an amazing talent for tak¬ 
ing technical jargon and putting it 


into words that someone like myself 
can understand. 

Debbie Fisher 
Kingston, Ontario 

Keep It Simple 

Just wanted to get a quick note off 
to you and let you know how much I 
enjoy the magazine. 

The articles are easy to read but 
are loaded with useful information 
that new computer users such as 
myself (two years experience) can 
utilize to make using a computer 
easier. In issue #5, I have used two 
of the simple batch files to simplify 
two tasks that can require several 
additional switches. Now when I 
format a 720K disk in my 1.44 meg 
B: drive, I use a simple batch file 
command. 

Some of the articles still get a lit¬ 
tle complicated for me, not because 
they have the computerese you read 
in other computer magazines, but 
more due to a lack of knowledge on 
my part. My 486 compatible is now 
being used to learn some QBasic 
programming and some minor play¬ 
ing with batch files and the scary 
Debug command. 

Douglas L. Holmes 
Mesquite, Thcas 


OMISSIONS AND CORRECTIONS 


Careful readers have caught two problems in DRG#5. On page 21 of 
“A Farewell to Incompatibility^ an error appeared both in text and the 
example listing. DRIVEPARM should read DRIVPARM. 

The tip “More Work From One * (page 13) incorrectly states that DOS 
lets you fit more than 127 characters on the command line. DOSs char¬ 
acter limit is, in fact, inviolable, but you still can use the tips sugges¬ 
tions for taking better advantage of the limited space. 

—Eds. 
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Simple But Effective 

Computers should be compatible, 
not only with each other, but with 
people as well—right? I have taken 
a baby step toward this end. 

Consider the DOS command that 
takes you from one drive to another. 
If you currently are using drive A, 
and you want to go to drive C, you 
ordinarily issue the command C: 
and press Enter. Wouldn’t it be bet¬ 
ter if you simply could press the C 
key and press Enter? Here is a little 
batch file that lets you do just that: 

0ECHO OFF 

C: 

Save it as C.BAT, making sure 
that the directory in which it re¬ 
sides is mentioned in your AU¬ 
TO EXEC.BAT’s PATH statement. 
Now you can go to drive C from an¬ 
other drive, without holding down 
the Shift key while typing a colon. 

Similar files—called A. BAT, 
B.BAT, and so on—can make switch¬ 
ing to other drives equally simple. 

Dale Patten 
Tbpeka, Kan. 

Patten’s method certainly works, 
hut this and other “simple” batch 
files do have drawbacks. Every file, 
including the shortest batch file, 
takes up a minimum of one cluster 
of disk space. The size of a cluster 
depends on the size of your hard 
disk and the version of DOS you 
used to format it, but it often is four 
sectors, or 2,024 bytes. (A sector is 
512 bytes.) 

Instead of using 2K of disk space 
for each command, you should con¬ 
sider creating macros with DOS 
5.0s DOSKEYcommand. These can 
accomplish the same thing faster 
(because you won’t have to wait 
while the system reads a batch file), 
and you’ll save on hard disk space. 
A guide to using DOSKEY appeared 
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in “DOSKEY Revealed,” DRGH5, 
page 28. You might also want to re¬ 
define your function keys to create 
DOS and drive shortcuts. A feature 
article, “Command Performance” in 
DRGH6, page 41, tells you how. 

—Eds. 

MORE Piping 

I just read DRG Number 5 and no¬ 
ticed examples of one of my pet 
peeves on pages 5, 13, 43, and 69: 
the use of needlessly wordy com¬ 
mand line constructs such as the 
following: 

TYPE filename | MORE 

You’re not completely to blame, as 
I have seen this given as an exam¬ 
ple of useful piping in several MS- 
DOS user’s manuals. If the people 
providing the operating system and 
writing the manuals know so little 
about the system, I can’t blame oth¬ 
ers for making this mistake. 

When piping is used, the output 
from one program has to be stored 
in a temporary file and later fed to 
the next program in the piping se¬ 
quence. The names of the pipe files 
can vary from one DOS version to 
another, but in DOS 4.0 they are 
P.l$$ and P.2$$ and often are called 
%PIPE1.$$$ and %PIPE2.$$$ or 
something similar. ( Later DOS ver¬ 
sions generate less pronounceable 
names, such as AOAPDRDO., that 
also lack an extension. — Eds. ) The 
command TYPE filename | MORE 
is approximately equivalent to: 

TYPE filename >%PIPE 1 .SS$ 

MORE <%PIPE 1 .SSS 
DEL VPIPE1 .S$S 

But this series of commands has 
two defects. First, it wastes comput¬ 
er time, because DOS must write 
the pipe file to disk before it sends 
the results to MORE.COM. Second 


it won’t produce the desired result if 
your current disk lacks sufficient 
space to store the output of the 
TYPE command. Instead, you’ll re¬ 
ceive an error message, such as 
“Intermediate error during Pipe.” I 
recommend that you use a faster 
and safer alternative: 

MORE < filename 

Norman De Forest 
Halifax, Nova Scotia 

You are absolutely right. The only 
excuse for the: 

TYPE filename \ MORE 

syntax is that it may be slightly easi¬ 
er for beginners to understand. 

—Eds. 

Optimized Problem 

I’ve had problems with memory-res¬ 
ident programs when running Fifth 
Generation Systems’ Fastback 
backup software, Quarterdeck’s 
Optimize memory management 
utility (which is part of QEMM), or 
the Mace Utilities. The documenta¬ 
tion accompanying Optimize recom¬ 
mends that, before running the pro¬ 
gram, you boot from a floppy 
system, but that procedure causes 
problems of its own. So, before I run 
any of the above-mentioned pro¬ 
grams, I run the following batch 
file, which I call FAS.BAT: 

0ECHO OFF 

C: | 

CD C:\ 1 

COPY AUTOEXEC.FAS AUTOEXEC.BAT 
COPY CONFIG.FAS CONFIG.SYS 
TYPE C:\TOOL\RE_BOOT.TXT 

AUTOEXEC.FAS and CONFIG- 
FAS are variations on my 
TOEXEC.BAT and CONFIG.SYS 
files from which I have removed 
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calls to memory-resident programs, 
such as Quarterdeck’s QEMM386- 
.SYS. RE_BOOT.TXT contains a 
message that reads: ‘'Now reboot by 
pressing Ctrl-Alt-Del or the reset 
button.” 

When I finish using Fastback. 
Optimize, or Mace, I restore my sys¬ 
tem's normal settings by running 
UNFAS.BAT and rebooting. Like 
FAS.BAT, the program contains* 
only six lines: 

0ECHO OFF 

C: 

CO C:\ 

COPY AUTOEXEC. NOR AUTOEXEC.BAT 

COPY CONFIG. NOR CONFIG.SYS 

TYPE C:\T00L\RE_B00T1.TXT 

CONFIG.NOR and AUTOEX- 
EC.NOR are the CONFIG SYS and 
AUTOEXEC.BAT files I normally 
use, and RE_BOOTl .TXT contains 
a “Now reboot and resume normal 
operation ” message. 

Paul Ramsey 
Chattanooga . Term. 

This is a fine way to manage two 
sets of configuration files. If you 
have more than two sets of these 
files, however . you may want to look 
for one of the many shareware pro¬ 
grams—BOOT SYS is one such pro¬ 
gram — that can handle multiple 
configurations dynamically. — Eds. 

Boot Disks 

Made for Downloading 

I enjoyed the article “Boot Disks for 
Every Occasion” {DRGti 1, page 4). 
It doesn't mention, however, that 
several utilities available on BBSes 
let you choose a specific configura¬ 
tion at bootup; among them are 
Dynaboot, CAM, and Coned. 
Personally, I prefer the boot disk 
technique described in the article 
even though I now' have a 386 with 
lots of memory; I just can’t stand a 


Program Listing 1. Copy this vorilon of 
CONFIG.SYS to a special downloading 
boot disk to help you keep your hard 
disk and regular floppy disks free of 
unwanted files. 
DEVICE*C:\DOS\HIMEK>SYS 
DEVICE=C:\D0S\Ettt386.EXE 
D0S=HIGH.UM8 

DEVICEHIGH=C:\D0S\ANSI.SYS 

DEVICE=C:\D0S\RAK)RIVE.SYS 896/D 

DEVICE=C:\DOS\RAMDRIVE.SYS 640/E 

DEVICES; \GM0USE. SYS +1 

BUFFER=20 

FILES=20 

STACKS=0,0 

FCBS=1 

LASTDRIVE=E 


cluttered hard disk. 

I’d like to share one obvious con¬ 
figuration that some of your readers 
may not be aw 7 are of. I use it in con¬ 
junction with my communications 
program, Procomm Plus, which I 
frequently use to gather informa¬ 
tion and programs from bulletin 
boards and mail systems. Because I 
don’t use most of the programs I 
download after trying them out, a 
housekeeping problem develops if I 
let unused files accumulate on my 
hard disk or a floppy disk. 

To keep things neat, I created a 
special bootable floppy disk for 
downloading. In addition to the 
usual DOS system files, the disk 
contains special versions of CON- 


Program Listing 2. This version of 
AUTOEXEC.BAT establishes a search 
path that lists programs, such as file- 
compression utilities, useful during 
downloading sessions. 

ECHO OFF 
C: 

PATH*A:\;B:\;C:\;C:\PCPLUS;C;\DO 
S;C:\D0S\UTILS;0:\;E:\C0 C\PC- 
PLUS 

End 


FIG.SYS and AUTOEXEC.BAT 
(see Program Listings 1 and 2). 
Both programs rely on commands 
available in DOS 5.0. 

The CONFIG.SYS in Listing 1 
creates two RAM drives, one 896K 
drive (drive D) and one 640K drive 
(drive E). I set up Procomm Plus so 
that files and mail, which generally 
are in compressed format, are 
downloaded to drive E, the smaller 
RAM drive. After I hang up and re¬ 
turn to the DOS prompt, I can de¬ 
compress the files, store them on 
drive I), and try them out. If I want 
to keep them, I copy them to a flop¬ 
py disk or my hard disk. 

The most important line in the 
AUTOEXEC.BAT file (Listing 2) is 
the PATH statement; it contains the 
location of the utilities I use with 
my communications program (file 
compression and decompression 
programs PKZIP and UNZIP, 
graphics files readers VPIC and 
DL-VIEW, and the like). 

When I download GIF or graphic 
files, I usually play with them to my 
heart’s content, seldom saving any. I 
unpack mail packets with Silly 
Little Mail Reader, a shareware 
utility designed for off-line mail 
reading. 

All these activities take place 
faster because the programs run on 
a RAM drive. Best of all, the dis¬ 
carded files are erased as soon as I 
shut ofT my computer or reboot. 

Leslie Lewis 
Greenville, S.C. 

In DOS 5.0, you also can create a 
RAM drive (use RAMDRIVE.SYS 
with MS-DOS and VDISK.SYS 
with PC-DOS) in either extended or 
expanded memory. Your DOS manu¬ 
al has the necessary instructions. 
Also, its essential that you copy to a 
hard disk or floppy disk any files you 
want to keep—before turning off 
your computer or rebooting. — Eds. 
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DUMP OF THE BATCH 


Making FIND Logical 

The DOS FIND command lets you search through a 
text file for a specific string of text, then it lists the lines 
in the file that contain the text string. For example, to 
list all occurrences of the word Beatles in the text file 
RINGO.DOC, you would type: 

FIND "Beatles" RINGO.DOC 

FIND also has command-line switches that let you 
display only files that don't contain the text string, 
place the file’s line number in front of the line dis¬ 
played, and—with DOS 5.0—make the search insensi¬ 
tive to upper- and lowercase letters. 

Unfortunately, FIND does not let you do logical 
searches. That is, you can’t use FIND to search for ail 
lines in a text file that contain two text strings or look 
for lines that contain one text string but not another. To 
overcome these limitations, I wTote a batch file, called 
FINDIT.BAT, that is centered around FIND and allows 
logical searches (see the Program Listing). 

FINDIT.BAT works by adding the logical operators 
AND, OR, and NOT to the FIND command. The AND 
operator combines two text strings and requires that a 
line in a text file contain both strings in order for it to 
be displayed. The OR operator combines tw'o text 
strings and requires that a line in a text file contain 
only one of the text strings in order for it to be dis¬ 
played. When you use the NOT operator, a line is dis¬ 
played only if it doesn’t contain a particular text string. 

Creating and Using FINDIT.BAT 

To use FINDIT.BAT, you first must type it in using 
DOS’s Edlin line editor, DOS 5.0’s Edit full-screen edi¬ 
tor, or a word processor that can save text in ASCII for¬ 
mat. Type in the batch file carefully. 

When you want to use the program, type FINDIT at 
the DOS prompt, following the batch file’s name with 
the name of the file to be searched and a text string to 
search for. With multiple strings, you also must use at 
least one of the logical operators AND, OR, and NOT 

For example, if you want to search a file called 
MICHELLE.DOC for the strings Paul and George , type: 

FINDIT MICHELLE.DOC Paul AND George 

FINDIT.BAT then displays on screen any lines in 
MICHELLE.DOC that contain both Paul and George. 
Note that FINDIT.BAT, unlike the FIND command, 
doesn’t expect, you to place quotation marks before and 
after each string you want to search for. Because of this, 
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FINDIT.BAT doesn’t let you search for text strings that 
contain a space. 

When using FINDIT.BAT, remember that DOS pro¬ 
cesses command-line parameters from left to right. This 
becomes important in commands such as the following; 

FINDIT APPLE.DOC John AND Paul NOT George OR Ringo 

When you first look at this line, it seems that it in¬ 
structs FINDIT.BAT to list all the lines that contain 
John and Paul but not George or Ringo. But that’s not 
the case. Because DOS processes the parameters from 
left to right, the command first finds all lines that con¬ 
tain John and Paul. Next, if any lines contain George , 
they are excluded. Finally, all remaining lines are dis¬ 
played, because the OR operator indicates that it 
doesn’t matter whether or not they contain Ringo. 

To rewrite the command so that it finds all lines that 
contain both John and Paul but do not contain either 
George or Ringo , use the following: 

FINDIT APPLE.DOC John AND Paul NOT George NOT Ringo 

If you run FINDIT.BAT under DOS 5.0, you can 
make the search insensitive to the case of the charac¬ 
ters in a string simply by placing an / on the command 
line prior to entering the filename, as in: 

FINDIT I MICHELLE.DOC Paul AND George 

If you leave out the /, or use a version of DOS prior to 
5.0, your searches will be case sensitive. 

IfFINDIT.BAT doesn’t locate any matches when it 
looks for a search string, it prints a blank line. 

Inside FINDIT.BAT 

Here’s a rundown of the program’s most significant fea¬ 
tures. (For simplicity, I’ve used line numbers even 
though batch file lines are not numbered.) Line 2 
checks to see if you enter anything other than the name 
of the batch file on the command line. If not, the batch 
file ends. If you enter a second parameter, lines 3 and 4 
check to see if it is an / or an i. (Parameters in FIND¬ 
IT.BAT begin with < /cO, so %1 is the second parameter.) 
If it is, an environment variable called SWITCH is set 
to /I so that FIND will make all comparisons insensi¬ 
tive to case. Then, a SHIFT command is executed so 
that the / no longer is the second parameter. If the sec¬ 
ond parameter is not an I or an i, program control 
jumps to the label :CONTINUE. skipping over the sec¬ 
tion labeled .SWITCH. 
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Program Listing. FINDIT.BAT overcomes many of the FIND com¬ 
mand's limitations, adding the ability to use the logical operators 
AND, OR. and NOT. The program also lets DOS 5.0 users conduct 
searches that are not sensitive to the case of the characters 
used in a search string. (Line numbers are for clarity only; do not 
include them when you type the program.) 

1 0ECH0 OFF 

2 IF m hl m — mm GOTO DONE 

3 IF -VI - -"! - GOTO SWITCH 

4 IF GOTO SWITCH 

5 SET SWITCH= 

6 GOTO CONTINUE 

7 :SWITCH 

8 SET SWITCH 3 /I 

9 SHIFT 

10 :CONTINUE 

11 SET FILESPEO*l 

12 SHIFT 

13 FIND VSWITCH* "%1" %FILESPEC% >F0UNDIT.S$$ 

14 :RESUME 

15 SHIFT 

16 SHIFT 

17 IF •%0***"and" GOTO AND 

18 IF "%0"**‘ , AND n GOTO AND 

19 IF -W-'or- GOTO OR 

20 IF "%0**“*0R* GOTO OR 

21 IF ■%0*»*"not" GOTO NOT 

22 IF "W^-NOT- GOTO NOT 

23 TYPE FOUNDIT.$$$ | FIND /V M .- " | 

MORE 

24 GOTO DONE 

25 :AND 

26 FIND ^SWITCH* m H\ m FOUNDIT.$$$ >TEMP.$$$ 

27 DEL FOUNDIT.SSS 

28 REN TEMP.SSS FOUNDIT.SSS 

29 GOTO RESUME 

30 : OR 

31 FIND %SWITCHV m hl m %FILESPEC% >TEMP.S$$ 

32 COPY FOUNDIT.SSS + TEMP.SSS FOUNDIT.SSS >NUL 

33 DEL TEMP.SSS 

34 GOTO RESUME 

35 :NOT 

36 FIND /V VSWITCH* "%r FOUNDIT.SSS >TEMP.SSS 

37 DEL FOUNDIT.SSS 

38 REN TEMP.SSS FOUNDIT.SSS 

39 GOTO RESUME 

40 :DONE 

41 SET SWITCH 3 

42 SET FILESPEC* 

43 DEL FOUNDIT.SSS 

End 


In line 11, the name of the file to be searched is 
placed in an environment variable called FILESPEC. 
Then a shift is performed to make the second parame¬ 
ter the first variable to be searched for. Line 13 per¬ 
forms the initial search, and the results are stored in a 
file called FOUNDIT.$$$. (In batch files, the extension 
$$$ is used almost exclusively for temporary files. 
Here I used it for this purpose to ensure that no file is 
overwritten accidentally by the temporary file.) 

From this point on, searches are performed according 
to the logical operators. Lines 15 and 16 shift the com¬ 
mand-line parameters so that the first and second pa¬ 
rameters are the logical operator and the search string, 
respectively (if they exist). Lines 17-22 check to see 
which logical operator was used. If none is found, FIND¬ 
IT.BAT assumes that the search is complete, and the re¬ 
sults are displayed (minus the 10 hyphens and a space 
that FIND would have printed before each filename) in 
line 23. The following line tells the program to jump to 
:DONE. and the subsequent lines (41—43) remove the 
environment variables from the DOS environment (free¬ 
ing environment space that may be needed by other pro¬ 
grams) and delete the temporary file FOUNDIT.$$$. 

If the operator is AND, lines 26-28 search the tempo¬ 
rary file FOUNDIT.$$$ for all lines containing the 
string immediately after AND, store the results in 
TEMP.$$$, delete FOUNDIT.$$$, and rename TEMP- 
.$$$ as FOUNDIT $$$. Line 29 subsequently directs the 
batch file to go to line 14 and begin the process again. 

If the operator is OR, lines 31-33 search the file for 
all lines containing the string immediately after OR, 
-tore the results in the file TEMH$$$, append the re¬ 
sults to the end of FOUNI)IT.$$$, and delete 
TEMP.$$$ Line 34 then directs the batch file to go to 
line 14 and begin the process again. 

Finally, if the operator is NOT, lines 36-38 search 
FOUNDIT.$$$ for all lines that don’t contain the 
string immediately after NOT, store the results in 
TEMP.$$$, delete FOUNDIT.$$$, and rename 
TEMP.$$$ as FOUNDIT.$$$. Line 39 then directs the 
batch file to go to line 14 and begin the process again. 

If, by a chance, you run out of environment space 
while running FINDIT.BAT, you can increase its size 
from DOS. 

Although FINDIT.BAT has limitations, it makes the 
DOS FIND command more powerful, providing logical 
search features even most w r ord processors and com¬ 
mercial file-search utilities lack. 

Vincent D. O'Connor 
Babbitt, Minn . 
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DOS 


□ I have a 386SX computer 
with 640K of RAM that I 
recently have expanded to 
8MB. However, my programs don’t 
seem to recognize or use the addi¬ 
tional memory. Changing my com¬ 
puter’s setup program doesn’t seem 
to help. I’m currently using DOS 
4.01. Do I need DOS 5.0? How can I 
put all of my new memory to use? 


Adding memory alone to a 
PC can’t always help PC 
programs. PC applications 
must be designed to take advantage 
of the memory above the 640K 
mark. This memory is called ex¬ 
panded (EMS) or extended (XMS) 
memory. If you’ve determined that 
your applications can take advan¬ 
tage of EMS or XMS memory, you’ll 
need to install a special program, 
called an upper-memory manager, 
to handle the allocation of all memo¬ 
ry above the 640K mark. 

Upgrading to DOS 5.0 provides 
one solution to your problem. DOS 
5.0 comes with an upper-memory 
manager, called EMM386.EXE. It 
handles both EMS and XMS memo¬ 
ry—as long as your applications 
support their use. If you choose not 
to upgrade to DOS 5.0, you can pur¬ 
chase a commercial memory manag¬ 
er from Quarterdeck Office Systems 
(QEMM386), Qualitas (386MAX), or 
several other companies that pro¬ 
vide upper-memory managers for 
many DOS versions. 

—J.W. 




I Keyboard macros created 
with DOS 5.0’s DOSKEY 

_| command work fine at the 

DOS prompt. I’d like a program, 
however, that provides the ability to 
“play back” a sequence of key¬ 
strokes within an application by 
pressing a single key—assuming 
the application doesn’t have its own 
macro capability. 


Now that major commercial 
soflware packages, such as 
WordPerfect, Microsoft 
Word, Borland’s Quattro Pro, and so 
on, provide their own macro lan¬ 
guages, the oner-i ipe market for 
DOS keyboard macro programs ha. c 
dwindled. One commercial program 
capable of feedin/ a series of 
keystrokes to many applications is 
Superkey, published by Borland. 
Version 1.16 is available for $99.95. 
Call (800) 331-0877. 

—J.W. 



After reading about the 
virtues of DOS’s CHKDSK 
command, 1 decided to run 
the program to check for irregulari¬ 
ties in the files stored on my 40MB 
hard drive. It returned the following 
message: 

10 lost allocation units found 
in 4 chains. Convert lost 
chains to files (Y/N)? 

Since I wasn’t expecting prob¬ 
lems, the message caught me com¬ 
pletely by surprise. Unsure about 
what to do, I answered by pressing 
N. What does the message mean? 
Are the files on my hard drive cor¬ 



rupted? Has damage been done to 
my files? If so, how can I go about 
repairing it? 

The message indicates that 
portions of four files (a total 
of 10 disk clusters) were 
misplaced by the DOS file-handling 
system. CHKDSK has identified a 
series of errors in your hard drive’s 
FAT. These errors can occur when 
DOS is interrupted while writing 
information to disk. You can cause 
the problem by removing a disk 
from your floppy drive while the red 
disk-activity light is on. In the case 
of hard drives, the culprit usually is 
a volt o :e surge or a power failure. 

Wht r the FAT gets damaged in 
this manner, clusters become “or¬ 
phaned,” which means they are de¬ 
tached from the file’s FAT cluster 
chain. As far as DOS is concerned, 
the clusters no longer belong to any 
file. The orphans themselves don’t 
pose a hazard, but they will contin¬ 
ue to consume valuable hard disk 
space until you free the space they 
occupy. To remove these orphaned 
dusters from the FAT, type: 

CHKDSK /F 

CHKDSK will display the same er¬ 
ror message as before. This time, 
answer by pressing Y. DOS will con¬ 
vert the orphaned clusters to a se¬ 
ries of ASCII text files named 
FILExrrx.CHK < where xxxx is a val¬ 
ue between 0000 and 9999); it then 
will free the orphaned clusters for 
future use. You can view the con¬ 
tents of CHK files by loading them 
into your word processor. 

—J.W. 
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□ I have heard a great deal 
about MS-DOS 5.0, but not 
so much about the latest 
version of IBM PC-DOS. Computer 
magazines used to make much 
more out of the distinctions be¬ 
tween the two. Are the two versions 
now the same, or are there differ¬ 
ences? If you had a choice, would 
you run PC-DOS on a non-IBM 
computer? Would you run it on an 
IBM computer? 


Up through DOS Version 
2.0, Microsoft let each ven¬ 
dor make internal modifica¬ 
tions to the operating system. Every 
version of MS-DOS could be differ¬ 
ent in subtle, but important, ways. 
The only well-known one w as IBM’s 
(because it was the most wide¬ 
spread), so many people used PC- 
DOS even on non-IBM computers. 

Unfortunately, this sometimes 
created problems for users interest¬ 
ed in programming in Basic, be¬ 
cause every IBM computer has ex¬ 
tra, copyrighted code in the ROM 
that contains part of Basic. The 
Basic included with PC-DOS runs 
only on computers made by IBM, 
and it locks up on all other comput¬ 
ers. The MS-DOS version of Basic 
(usually called GW-Basic) runs on 
all DOS computers, including IBM 
machines. 

Beginning with Version 3.0, 
Microsoft has maintained complete 
control over MS-DOS. Vendors no 
longer can change the internal code, 
and MS-DOS is a known entity. 
Also, minor operational differences 
betw'een IBM’s and Microsoft’s ver¬ 
sions have disappeared. 

I have not tried IBM’s version of 
DOS 5.0. I have heard that its 
QBasic and EDIT.COM programs 



use the special ROM code and 
therefore will run only on IBM com¬ 
puters. But I see no reason to use 
PC-DOS on a non-IBM computer. 

If I used an IBM computer, I like¬ 
ly would use MS-DOS anyway, be¬ 
cause it has a lower street price (a 
higher volume of sales brings a low¬ 
er cost) and because it is now the 
best-known version. I have not 
heard of any reason, however, to 
avoid using PC-DOS 5.0 on an IBM 
computer. 

—H.B. 


□ I know this will sound sim¬ 
ple, but what are hidden 
files, and why are they on 
my system? Can I look at them? 
When would I need to create a hid¬ 
den file? 


The most common hidden 
files are the tw'o system 
files that enable your corn 
puter to boot and run DOS. The in¬ 
visibility of these files is one of the 
characteristics DOS inherited from 
the earlier CP/M operating system. 
(In CP/M, system files did not ap¬ 
pear in a directory listing. Since 
those files w r ere so important to the 
computer’s operations, CP/M’s cre¬ 
ators wanted to make it difficult for 
users to alter or delete them.) 

If the CHKDSK command reveals 
a third hidden file, it’s likely the file 
holds the label name of the disk you 
are checking. The name was as¬ 
signed when you formatted the disk 
or when you later ran the LABEL 
command. Other hidden files can be 
created when you run the installa¬ 
tion routines of your application 



programs; sometimes the copy-pro¬ 
tection schemes found in commer¬ 
cial programs create hidden files on 
your disk. 

You can reveal and hide again 
such files using DOS 5.0’s ATTRIB 
command or the DOS shell’s Change 
Attributes option. (For more on this, 
see the article “Positive Attributes” 
in DRGX5, page 15J 

ATTRIB or the DOS shell also 
can be used to hide other files. You 
might want to do this to reduce the 
clutter in your directory listings or 
to prevent others from finding your 
files (although if you can hide them, 
dedicated snoopers can uncover 
them easily enough). For example, 
if you were a teacher and w anted to 
hide the file that contained answers 
to a test, you could enter this DOS 
5.0 command: 

ATTRIB +H ANSWERS.DOC 

To reveal the file later (after the 
test), you would enter the following 
command: 

ATTRIB -H ANSWERS.DOCs 

—J.L 


Should I include SETVER 
in my AUTOEXEC.BAT 
file? If I use a lot of older 
programs with DOS 5.0, how do I 
tell SETVER which programs I am 
using? 



Many applications begin by 
asking for the computer’s 
installed DOS version 
number to make sure they can w ork 
correctly. If DOS passes an incom- 
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Q&A: DOS, DISKS, AND DILEMMAS 


patible DOS version number, some 
older applications will refuse to run. 
DOS 5.0’s SETVER command “lies” 
to selected programs, telling them 
that an earlier version of DOS is 
running. SETVER also keeps a list, 
called the version table, in memory 
and on disk, that includes the 
names of such uncooperative pro¬ 
grams and the DOS version each re¬ 
quires. 

You can use the SETVER com¬ 
mand from the DOS prompt to view 
the table, add programs to it, and 
delete programs when you upgrade 
to newer versions. You have to add 
a program to the list only once, so 
you never need to put SETVER into 
AUTOEXEC.BAT or any other batch 
file. Tb run SETVER, you first must 
load it into memory by adding this 
line to your CONFIG.SYS file: 

DEVICE S C: \DOS\SETVER.EXE 

—J.W. 


you use, smaller partitions could re¬ 
sult in smaller allocation clusters. 
DOS allocates file space in clusters, 
or groups of sectors. On average, 
each file wastes half a cluster. 
Because of the limitations in DOS’s 
method of allocating storage, larger 
drives have larger clusters. If small¬ 
er partitions reduce your cluster 
size and you have thousands of 
files, each file might waste, say, 
2,000 bytes instead of 8,000 bytes. 
This might yield several megabytes 
of extra storage space. 

Another reason for partitioning a 
drive is to put related files closer to¬ 
gether so that the read/write heads 
don’t have to move so far from one 
file to another. However, this speeds 
up disk access only if you organize 
your data and applications in subdi¬ 
rectories and if you periodically run 
a defragmenter to ensure that files 
are stored in contiguous sectors. 

—J.W. 


HARDWARE 


I have a computer with a 
330MB hard drive. I have a 
single partition on the drive 
so that everything appears as drive 
C. Would I gain anything by break¬ 
ing up my drive into smaller drives? 
Would partitioning slow down my 
hard drive? Can I partition the 
drive without removing all the data 
and reformatting? 

□ Whether a drive should be 
partitioned or not depends 
on how you are using it. If 
you have multimegabyte data files 
or dozens of interconnected data¬ 
base and accounting files, or if the 
drive is serving a network with cus¬ 
tom software that expects all of its 
files in a certain location, then your 
best bet is probably to leave it as 
one large drive. 

On the other hand, if you have 
many small files, you might be bet¬ 
ter off with a partitioned drive. 
Depending on the version of DOS 
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I live in an area that fre¬ 
quently is besieged by se¬ 
vere thunderstorms. Prior 
to a storm, I usually pull the power 
plugs that connect my PC and mo¬ 
dem to household current. How¬ 
ever, underground utilities recently 
have replaced the utility poles in 
our neighborhood. Is it still impor¬ 
tant to “pull the plugs” before each 
storm? 



Underground utilities pro¬ 
vide no measure of protec¬ 
tion from storm-induced 
surges. Although the utility 
your neighborhood may be 
buried deep in the ground, a light¬ 
ning strike at an electrical substa¬ 
tion (located above ground) up to 30 
to 40 miles away can be powerful 
enough to ruin your PC. In addition, 
pulling only the power plug that 
connects your modem to the electric 
company is not enough to protect it. 
You also must provide some form of 
voltage surge protection for your 
telephone line, or you must discon- 


□ 

voltage 
lines in 


nect the line from your modem prior 
to a thunderstorm. 

The only reasonably safe way to 
protect your PC and modem from 
power surges and current sags is to 
install a UL-approved surge sup¬ 
pression or line-voltage conditioning 
system. An inexpensive surge sup¬ 
pressor costs less than $50. A line- 
voltage conditioning system that ad¬ 
justs for power fluctuation may cost 
from $200 to $500. Of course, un¬ 
plugging the equipment is a simple, 
cost-free way to solve the problem, 
provided you can get Mother Nature 
to issue you a weekly storm sched¬ 
ule, especially for those times when 
you’re out of town. 

—J.W. 



I've heard people talk about 
| using a computer network 
| called Internet. It sounds 
like an on-line service. Where would 
I join? 


□ Internet is a computer com¬ 
munications network that 
links most of the academic 
institutions, government research 
facilities, and military posts in the 
United States and throughout the 
world. It’s based on the National 
Science Foundation Network 
(NSFnet), a computer network that 
links universities to many corporate 
networks. Most users of Internet 
are employed at one of 2,000 sub¬ 
scribing colleges, universities, cor¬ 
porations, or research facilities. At 
present, no commercial users are al¬ 
lowed. If you’re serious about giving 
Internet a try, I suggest you contact 
the MIS or computer science de¬ 
partment of a major college or uni¬ 
versity in your area. Some universi¬ 
ties sell external accounts. Also, a 
number of public-access networks 
exist, which, for a small fee, will 
give you access to Internet. 
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GRAPHICS 


□ I don't understand graphics 
file formats. There are 
GIF. PCX. TIFF. MSP. 
BMP, and others. Why so many? Is 
there an established industry 
standard? Which file format 
should I consider to ensure the 
software I buy will be able to read 
graphics files created by other 
programs? 

□ Perhaps the best way to 
explain the proliferation of 
graphics file formats is 
to consider why each was devel¬ 
oped and how it has evolved as a 
standard. 

The GIF (Graphics Interchange 
Format) was developed by Compu¬ 
Serve Information Service (CIS), 
the Columbus, Ohio, on-line service, 
to allow members to exchange 
graphics files no matter what kind 
of computer equipment they 
owned—Apple IIs, Macintoshes, or 
PCs. The GIF format has evolved as 
a standard by virtue of the millions 
of subscribers who exchange graph¬ 
ics data through CIS. 

One GIF advantage is its bui lt-in 
file compression, which de- I 
creases the amount of time it 
takes to transfer files. 

The PCX format was devel¬ 
oped by Zsoft Corp. of Marietta, 

Ga., in the early days of the PC, 
to support PC Paintbrush—one 
of the first commercially suc¬ 
cessful PC “paint” programs. 

This format became a standard 
by virtue of its age and wide¬ 
spread use. Owners of the lat¬ 
est version of PC Paintbrush, 
if they have the proper equip¬ 
ment, can choose from a palette 
of 16.7 million colors. 

The TIFF (Tagged Image File 
Format) was popularized by 
the advent of desktop publish¬ 
ing and programs such as PC 
PageMaker and Ventura Pub¬ 
lisher. The TIFF was developed 
originally to provide support 
for printing black-and-white 


photographic style images. It’s a 
very efficient format for manipulat¬ 
ing and storing gray-scale image 
data. By the way, TIFF is a some¬ 
what misleading acronym; you will 
see TIFF files named only TIF in 
your directories because of DOS’s 
three-letter limit on filename exten¬ 
sions. 

The MSP (Microsoft Paint) and 
BMP (Bitmap) formats were 
spawned by the success of Micro¬ 
soft’s Windows operating environ¬ 
ment. Early versions of Windows 
provided only minimal support for 
graphics images in only two colors. 
The MSP format was the first to in¬ 
troduce the concept of dithering (a 
series of individual graphic dots dis¬ 
persed in patterns to simulate 
shades of colors). Dithering provides 
the illusion of more colors in images 
composed of only a few colors. Later, 
as Windows evolved to provide sup¬ 
port for more colors, the BMP for¬ 
mat emerged. It recently has 
become the “official” way to inter¬ 
change graphics files (internally) be¬ 
tween Windows programs. 

Unfortunately, there isn’t a single 
graphics file format upon which you 
can hang your hat, nor will there 
likelv be one in the future. If f had to 


pick one (and only one) graphics file 
format, for compatibility’s sake, I 
would choose the PCX format. It re¬ 
mains the most widespread graphics 
file format in current use. 


—J.W. 


WINDOWS 


□ 


I tried to multitask in 
Windows while running a 
communications program 
in the background and downloading 
messages. I was trying, at the same 
time, to format a new box of disks. 
But each time I tried, my communi¬ 
cations program hung up. Does 
Windows multitask or not? 


□ 


We’re Looking for 
A Few Good TIPS! 

Have you ever discovered a new way of 
using a DOS command or written a 
clever batch file to perform a repetitive 
task? Sure you have! And DOS 
Resource Guide wants to publish your 
secrets. Send us your best tips and 
hints for publication and receive the 
undying gratitude of DOS users 
around the world. 

Send your best DOS tips and 
batch files to: 

DOS Resource Guide 

80 Elm St. 

Peterborough, NH 03458 


Window's accomplishes 
multitasking by time slic¬ 
ing—assigning each pro¬ 
gram, in turn, a small amount of 
processor time. This gives the ap¬ 
pearance of simultaneous program 
execution. 

Communications programs have 
very precise timing needs, especial¬ 
ly at high data-transfer rates. In ad¬ 
dition. they need proper handshak¬ 
ing to keep the data flow from 
exceeding their buffers. Such 
programs can operate in the 
background more efficiently if 
the foreground program does 
not take too much CPU time 
when running. 

FORMAT is a particularly 
demanding program, and the 
only way to get it to operate ef¬ 
ficiently would be to increase 
somewhat the percentage of 
the time slice that’s allocated 
for the background application. 
Making such a change requires 
considerable programming 
savvy. It also is possible, how¬ 
ever, that your communications 
program cannot handle the sit¬ 
uation you describe; in that 
case, substituting another 
package may well solve the 
problem. 




_ 


: 


J.N.J. 
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)OKIN ON DOS 


Clean Up Your 
Hard Drive—Now! 


Clutter 
thrives. 

The result is a 
hard drive with 
lower 

performance. 


N othing distresses me more than a poorly 
organized hard drive. It’s what I call 
the “creeping clutter* syndrome. This is 
evident in garages throughout the countrv. 
People keep the strangest stuff, either for 
sentimental reasons, out of 
nostalgia, or under the no¬ 
tion that “starting tomorrow 
I’ll seriously use that Soloflex 
and get into shape.* Who are 
we kidding? 

We can get away with 
shoving our excess stuff into 
the garage because we don’t 
live there. The clutter is “in¬ 
visible.” We may only notice 
it as we mistakenly walk— 
and crunch—over the old 45s 
one day (and then leave 
them there). But if we had to 
escort our house guests—or 
worse, parents—in through 
the debris and litter, we’d do 
something about it. 

Sadly, some users apply 
the same “shove it into the 
garage* apathy to their com¬ 
puters, sticking files every 
which where and not really 
caring whether their hard 
drive is organized. DOS is partially to blame 
because it’s stupid and offers no rules or sug¬ 
gestions for organizing your drive. So clutter 
thrives, and the result is worse than a 
Beirut-like garage: It’s a hard drive with 


lower performance. And it will be an endless 
source of frustration for you when it comes 
time to find that one file lost in the bottom of 
the heap. 

Clean. Then Organize 

The solution is to follow a few simple rules of 
organization. This is something that must be 
done intentionally on your part. Don’t expect 
any suggestions from DOS—no smiling, no 
winking, no nudging in the right direction. 
You must make a conscious effort at organi¬ 
zation. 

There are really only two rules: 

1. Keep the root directory clean. 

2. Use subdirectories to organize your files. 

Number one is easy. The root directory, the 
main directory on every hard drive, should 
be as garbage-free as possible. This means 
the only files that should appear there are 
the files that absolutely must be in the root. 
Everything else should be a subdirectory into 
which you’ll place the rest of the refuse. 

Files tend to grow in the root directory 
like flies around an idle cow. Of all the files 
that find their way into the root, only two are 
absolutely required: CONFIG.SYS and 
AUTOEXEC.BAT. A third is COMMAND 
COM, though there are ways to stick that in 
a subdirectory. So without getting technical, 
say three files—the three I just mentioned— 
are all you need in the root. Everything else 
should be hosed away like offal. 


BY DAN GOOKIN 
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Get to the Root 

Keeping the root directory clean is a chore. 
Other files may show up in the root from 
time to time, like strange relatives you didn’t 
know you had but who are glad to see you 
anyway. These friendly pests are OK, pro¬ 
viding you didn’t copy or create them there 
yourself. For example, DOS’s Mirror com¬ 
mand creates a file named MIRROR.FIL 
that stops by the root directory and sits a 
spell. Other disk utilities put files in the 
root: The Norton Desktop for DOS (and for 
Windows) puts special files there, and your 
backup program may plant a few files 
That’s OK Everything else on your comput 
er should obey rule number two: use subdi¬ 


rectories to organize your files. 

By the way, DOS itself imposes a limit that 
affects your root directory’s cleanliness. DOS 
lets you pile about 500 files into the root di¬ 
rectory of a typical hard drive before it com¬ 
plains with the confusing “Disk Full” error 
message. (The entire disk isn’t really full, but 
no more files can be added to the root directo¬ 
ry.) If you reach this point, you’ll need to use 
subdirectories if you expect to load more files 
on your hard drive. 

Let Subdirectories Help 

The object of rule two, hard disk organiza¬ 
tion, is to put each of your programs in its 
own directory. Most INSTALL or SETUP 


DOS’S DIRECTORY COMMANDS 


MKDIR or MO 

Format: MKDIR pathname", also MD pathname 

The pathname is the name of the directory you 
want to create. If you don’t specify a full pathname 
with all related subdirectories, DOS makes the new 
directory a subdirectory of the current one 
The pathname follows the same DOS rules as for 
naming files: up to 8 characters for the directory 
name, followed by an optional dot and up to three 
characters for an extension (though extensions are 
uncommon for directories). You may not use the 
following characters in a directory name 

(space) ."/\[] :*!<>+=;,? 


CHDIR or CD 

Format: CHDIR pathname; also CD pathname 

When followed by the pathname or simply the 
name of a directory, this command will log you to 
tnat directory in the current drive. 

When CHDIR or CD isn’t followed by anything, 
DOS displays the full pathname of the current 
directory. 


RMDIR or RD 

Format: RMDIR pathname, also RD pathname 

The RD command removes directories The directory 
must be empty. You must delete all files and 
subdirectories before RD will work. Also, you can’t use 
this command while you’re “in" the directory you’re 
deleting 

— D.G. 
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programs do this automatically. 

For example, WordPerfect copies every¬ 
thing to a WP51 directory it creates. 
Further, it gives you the option of creating 
individual subdirectories for WordPerfect’s 
graphics, macros, speller, printer, backup 
files, and so on. The advantage is that you 
aren’t left clueless when you see a file 
named WP1WPIUS.LEX in a directory list¬ 
ing. If the file is in the WP51 subdirectory, 
then you know it’s a WordPerfect file. And if 
it’s in the WP51XSPELL directory, you know 
the file has something to do with the 
WordPerfect spelling checker. 

This is a key advantage of organizing with 
subdirectories: They give you more clues to a 
file’s content than the limited 8-character 
filename allows. 

Installation programs can organize your 
applications, but it’s up to you to organize 
the files you create with those applications. 
If you haphazardly stick files all over the 
hard drive or, for example, you keep your 
WordPerfect documents in the main WP51 
directory', you’re still contributing to the clut- 
■ ter. Instead, you must use 
DOS’s crude tools to chisel 
some subdirectories into 
your drive. Arrange files 
into subdirectories and 
you’ll not only be keeping re¬ 
lated files together, but 
you'll have a better idea of 
what each file is for. 

You can use DOS's MKDIR 
command to create new di¬ 
rectories (see the sidebar for 
specifics on using MKDIR 
and DOS’s other directory 
commands). Directories are 
named just lik* files, and 
you can stick them any¬ 
where: in the root directory, 
under other directories, and 
so on. For example, you can 
create a primary PRO¬ 
JECTS directory. Under 
that, create subdirectories 
for each of your projects: 
WORK, EXPO, PROGRAM, 
and so forth. If you want to be more orga¬ 
nized, make deeper levels of subdirectories. 
The more specific you can get, the better. 

Select clever and appropriate names for 
your directories. Suppose you work at an ad 


Subdirectories 
give you 
clues to 
a file’s 
content. 


agency. The main work directory might be 

called WORK Under that directory are sub¬ 
directories for each of your clients. In the 
PEARSON directory, you might have addi¬ 
tional directories for each project related to 
that client. At the very end, you might have 
a nondescript ARTWORK.AI file—which 
could be anything. But if it’s in the 
\WORK\PEARSON\SPRING subdirectory, 
you have a clue that it’s artwork for the 
PEARSON account’s SPRING project. This 
has the advantage of being far more descrip¬ 
tive than a simple 8-character filename, as 
well as keeping your stuff organized. 

Another advantage to organizing your 
work by projects is that you can toss unrelat- 
ed files together in a common directory. For 
example, if you put all your documents into a 
subdirectory under WP51, all your graphics 
in a subdirectory under PAINT, and Page¬ 
Maker files in a subdirectory under PM4, you 
have files related to a single project in three 
different directories. By comparison, keeping 
everything in specific subdirectory means 
ail the project file.- are together, regardless of 
which program created them. 

Backing up files is easier if you keep pro¬ 
ject files together. At the end of the workday, 
you only need to back up the few files in the 
current project directory. I use this method to 
back up my day’s work. It only takes a few 
minutes and a single disk instead of half an 
hour and a stack of disks. 

Commit Yourself 

Even with all this organization, the job of 
maintaining a clutter-free hard drive is an 
ongoing commitment. Other aspects of the 
basic organizational problem become in¬ 
creasingly important: Creating a search path 
to help you find programs, locating lost files, 
and regular disk housekeeping (renaming, 
copying, and deleting files) need to be done 
daily. Again, DOS offers no rules or sugges¬ 
tions. But trying to get organized every once 
in a while—just like shoveling out your 
garage— makes your hard drive house a lit¬ 
tle easier to live in. ■ 


Don Gookin is the author of the best selling book 
DOS for Dummies (IDG Books). His 
Supercharging MS-DOS i Microsoft Press) 
contains more tricks and hints on using DOS . 
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The Roots of DOS 

How could anyone invent so arcane an operating system as DOS? 
Was it an evil master plan to promote the use of 
backslash and piping symbols? 


by James Langdell 


ome aspects of DOS seem purely arbitrary— 
at least until you’ve used them for so long 
that you take them for granted. Rut somr - 
| times you start to wonder.... Why Jo 1 have 
to type backslashes so often? Why do so many filenames 
have periods in the middle? And, for that matter, why do 
so many commands have short cryptic names? Many 
PC users have w anted to ask the creators of DOS a 
question that w r as raised once in a software ad: a Is this 
what you intended, or did it just turn out that way?” 

The answers to some of these questions are found in 
the two very different operating systems—CP/M and 
Unix—that provided models for DOS. In fact, DOS is 
sometimes described loosely as a cross between CP/M 
and Unix. 

Upward From CP/M 

CP/M (originally short for Control Program/Monitor, al¬ 
though the word microcomputers eventually was sub¬ 
stituted for monitor) is an operating system developed 
by Digital Research, the company that later developed 
DR DOS. an alternative to MS-DOS. Around 1975, 
about six years before the IBM PC w r as introduced, 
Digital Research created CP/M to run computers using 
the Intel 8080 processor and the related Z80 chip. Well- 
established companies, such as Osborne and Kaypro, 
sold popular machines built for these processors and 
CP/M. The initial form of DOS, available in 1981 for the 
first IBM PCs, essentially was a CP/M adaptation that 
could run on the PC’s 8088 processor. 

CP/M enabled personal computers to handle disk 


drives. The operating system permitted disk files with 
names of up to eight characters followed by a three- 
character extension, lire two parts of the filename w f ere 
separated by a period. From the start, DOS adopted this 
filename convention, and those tight limits on name 
lengtns are still imposed on DOS files and directories. 

Later versions of CP/M (starting with Version 2.0) 
gained the ability to handle hard disks as well as flop¬ 
pies and to organize disks in a new way. A large disk 
< ./d be divided into as many as 16 user areas (identi¬ 
fied by numbers from zero to 15) containing different 
groups of files Hie files in each area, however, were all 
on the same level. CP/M still didn’t offer a way to organ¬ 
ize files into subgroups or for its existing groupings to 
be known by meaningful names. 

Downward From Unix 

CP/M’s shortcomings already had been overcome by the 
Unix operating system in the 1970s. Developed for 
minicomputers at Bell Labs, Unix was structured 
around the concept of files in a directory hierarchy. 
Files were located either in a root directory (known as /) 
or in a subdirectory that had a meaningful but often 
terse name, such as bin (for program files). Unix also 
could accommodate multiple users on the same ma¬ 
chine, allowing numerous home directories for each 
user. These aspects of Unix have allowed great flexibili¬ 
ty and have not changed over the years. 

Any directory can have further subdirectories, so the 
location of a given file must be specified in terms of its 
directory pathname, as in, for example: 

/usr/1ocal/bln/Backgammon.Plus.txt 

Notice that in Unix, names of individual files and di- 



January 1993 


Number 7 • DOS Resource Guide 17 









OMtM Of THE SPECIES 


rectories aren’t bound by the same 
limits as in CP/M and DOS. Each 
filename or directory name can con¬ 
tain more than 11 total characters 
and can be separated into more 
than two parts by periods. Even 
though Unix can handle rather long 
filenames, its programmers gave 
many commands, files, and directo¬ 
ries short, cryptic names in the in¬ 
terest of efficiency. 

Lowercase letters predominate in 
the Unix command line. Unix dis¬ 
tinguishes between lower- and up¬ 
percase versions of the same letter, 
while DOS lets you use them inter¬ 
changeably. In addition, notice that 
the slashes separating the directory 
levels are forward slashes—not the 
backslashes so familiar in DOS (but 
nowhere else). 

At the time DOS started adopting 
a Unix-like directory structura--in 
DOS 2.0—it couldn’t make use of the 
ordinary slash, because that piece of 
punctuation already was spoken for 
within the operating system. The 
“front slash” had been reserved 10 in¬ 
dicate options for some of the earliest 
DOS commands. The DIR /W com¬ 
mand, for example, displays a wide 
list of filenames. (Unix, on the other 
hand, uses hyphens to introduce 
command options, as in the directory 
listing command 1 s -1.) 

If DOS also had used regular for¬ 
ward slashes to separate directo¬ 
ries, there would have been great 
confusion for both PC users and the 
PCs themselves. Confronted with 
the command DIR /W, DOS wouldn’t 
have known whether to display the 


current directory in wide format or 
to list the data about a first-level di¬ 
rectory (or root-directory file) called 
W. When the creators of DOS real¬ 
ized such syntax conflicts would oc¬ 
cur, backslashes must have seemed 
the next best thing to use as separa¬ 
tors in the operating system’s new 
directory pathnames. 

Common Aids to Navigation 

Despite its problem with slashes, 
DOS successfully carried over from 
Unix some other punctuation 
marks related to directories. In both 
operating systems, you can type a 
single period (.) to stand for the cur¬ 
rent directory and double periods 
(..) to stand for the directory imme¬ 
diately above the current directory. 

For example, to erase all files in 
the current directory; you can use a 
single period in place of*.*: 

DEL . 

The equivalent Unix command is: 
rm . 

To copy a file to the current direc¬ 
tory from the level above it, in DOS. 
you can refer to that position with 
the double-period sign. For exam¬ 
ple, say you were in a subdirectory 
below a word processing program’s 
template directory, named \PRO- 
GRAMSXWPROC. You could copy 
and rename a letter template file 
with a command such as: 

COPY ..\LETTER.FRM 92-05-27.LTR 


That’s much less typing than the 
alternative command that ignores 
the preceding shortcut: 

COPY \programs\wproc\letter.frh 

92-05-27.LTR 

If a desired file is several directo¬ 
ry levels above your current directo¬ 
ry, you can write a pathname that 
stacks up the double periods (..\..). 
Or, if the desired directory is in a 
subdirectory parallel to your cur¬ 
rent directory, you can use the dou¬ 
ble periods to direct DOS to look up 
one level and then down again. 

Let’s say you were in the \PRO- 
GRAMS\DATABASE\REPORTS 
\1992 directory. You could copy a 
file from the directory containing 
the previous year’s reports with this 
command: 

COPY ..\1991\SALES.DAT 

In Unix, this would be the equiva¬ 
lent command: 

cp . /1991/sales.dat 

Gv‘ rng directly to the root directo¬ 
ry is handled the same way in both 
operating systems: You enter the ap¬ 
propriate slash to designate the root 
directory in a DOS command (CD \) 
or a Unix command < cd /). 

An additional piece of navigation¬ 
al punctuation comes into play in 
Unix. Remember that, in Unix, 
multiple users can work simultane¬ 
ously within the same system’s file 
structure. On these multiuser sys¬ 
tems, another important desti¬ 
nation is each user’s home direc¬ 
tory, which resides under a 
common root directory. The cd 
command, by itself, will take you 
directly to your home directory. 
You also can use the tilde symbol 
(~) to describe directories rela¬ 
tive to that home directory, as in 
this command: 

cd -/projects/perpetual.motion 


SUPER SORTING 

Want to locate frequently used files in a snap? Under DOS 5.0, you can 
use special characters to ensure such files are placed at the beginning of 
directory listings. When sorting directories, DOS places files beginning with 
the following characters first:!, #, $, %, &, \ (,), -, and @. 

Numerical values (zero through nine) and letters (A-Z), respectively, 
follow these characters in any directory listing that’s sorted by filename. 

Naming a file IMYDOC.TXT, therefore, would place it at the beginning of a 
file listing. 

—Jack Nimersheim 


(See the sidebar, “Tips for 
Unix Beginners." for other Unix 
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TIPS FOR UNIX BEGINNERS 

If you ever have occasion to use a Unix 
system, you'll find much of what you 
know about DOS is useful on the new 
machine—as long as, for starters, you 
remember to type slashes that face the 
proper direction. 

A few commands, such as cd. mkdir, 
and rmdir, have the same names and sim¬ 
ilar functions in both operating systems 
The piping and redirection symbols (I, >, 
and <) work the same way in both. In 
addition, other useful commands are 
functionally similar, but their Unix names 
differ from those you're used to in DOS 
A lot of skills you've practiced in DOS 
will work in Unix if you remember these 
translations of common commands 

• Is replaces DIR 

• cat replaces TYPE 

• cp replaces COPY or XCOPY 

• rm replaces DEL or REMOVE 

• mv replaces RENAME 


If you need to go back and forth 
between the two operating systems, you 
can give your personal random-access 
memory some relief by using batch files 
within DOS and by taking advantage of 
Unix’s alias feature to make both sets of 
command names work on both machines 
For example, to have Unix’s cat command 
work as you would expect on a DOS 
machine, you simply can create a batch 
file, named CAT.BAT. that contains this 
single line: 


equivalents of DOS commands 

In DOS, entering the CD com¬ 
mand by itself will tell you only 
what your current directory is. Rut 
in Unix, cd moves you to the home di¬ 
rectory. Unix’s pwd command prints 
the path of the working directory. 

Directories and Hidden Files 

In addition to Unix’s directory’ struc¬ 
ture, DOS also adopted some Unix 
commands for managing directories. 
MKDIR, RMDIR, and CD appear 
under those names in Unix as well 
as in DOS. But the synonyms for 
those commands—MD, RD, and 
CHDIR—are unique to DOS. 

Some Unix commands are better- 
equipped to handle directories than 
are their DOS equivalents. The Unix 
mv command (short for move) can re¬ 
locate and rename a directory, along 
with the files and subdirectories 
within that directory. In DOS, you 
need to enter multiple commands to 
create a new version of a directory 
and then delete its old form. 

Another operating system feature 


TYPE %1 %2 %3 %4 %5 

The numbers with percentage signs 
cause the TYPE command to process any 
filenames or redirection instructions you 
typed unwittingly on a cat command line, 
such as this: 


cat report.txt > prn 


J.L 


DOS offer) by providing the 
chown command (short for 
change ownership) to let you 
set permission levels on your 
files. Different permission lev¬ 
els can prevent other users 
from executing them as pro¬ 
grams, from changing or 
deleting data or program files, 
or from accessing a file or di¬ 
rectory at all. The chown com¬ 
mand packs this clout, and it 
provides an example of how 
Unix, unlike DOS, was de¬ 
signed right from the start to 
handle multiuser operations. 


that differs among CP/M, Unix, and 
DOS is the way files can be hidden. 
CP/M didn’t have a specific cap go;y 
of hidden files. If you designated 
a file as a system file through 
the STAT command, however, it 
wouldn’t appear in the DIR com¬ 
mand’s list of files. 

DOS has a richer set of file at¬ 
tributes than CP/M, including a 
separate attribute for hidden files, 
which lets you hide other files be¬ 
sides system files. In DOS 5.0, you 
can set or remove hidden or system 
attributes with the ATTRIB com¬ 
mand. (See the article “Positive 
Attributes” in DRG #5, page 15.) 

In Unix, a file is hidden when you 
give it a name that begins with a 
period, such as this: 

.peek-a-boo 

Files with such names don’t appear 
in normal directory listings. 

But Unix goes well beyond this 
level of protection (as well as the 
read-only protection that CP/M and 


96 Million Users 
Can’t Be Wrong 

Despite its somewhat arcane 
structure, DOS is the operat¬ 
ing system of choice for most 
computer users. Estimates of 
the number of DOS units in 
the marketplace run as high 
as 96 million. Like the awk- 
ard, so-called QWERTY 
keyboard (which actually 
was designed to slow down 
nmible-fingered typists), DOS is a 
convention that’s likely to stick 
around for some time. It’s extremely 
cost-effective for computer users 
working independently, and DOS 
users are free to choose from a wide 
range of programs. Furthermore, 
DOS is continuing to evolve. 

Like Unix and CP/M before it, the 
roots of DOS were firmly planted in 
the fertile minds of computer pro¬ 
grammers and other technical wiz¬ 
ards. Over time, however, the oper¬ 
ating system has continued to move 
toward the language and needs of 
everday users like you and me. 
(DOS 5.0’s shell environment is a 
good example of that.) Yes, you still 
have to deal with backslashes, Cop¬ 
tic commands, and awkward file¬ 
names. But then, what else would 
you have to complain about? ■ 


James Langdell is a technical writer 
for Sun Microsystems and author of 
the PC Resource MS-DOS Insert 
collection. 
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AND EXIT CODES 


Unlocking the Secrets 
Of Exit Codes 


Exit codes have puzzled many a novice batch-file writer. DOS’s exit codes, and 
the IF ERRORLEVEL batch file subcommand that uses them, can effectively 
enhance the safety and performance of your batch programs. 


by John Wolfskil! 


H or more than a decade, batch files have pro¬ 
vided millions of DOS users with a small 
but powerful set of time-saving tools. For 
me, writing a batch file is like eating a bag 
of crunchy potato chips: After I’ve finished one, I imme¬ 
diately look for an excuse to start on a few more. Simple, 
yet wonderfully arcane in style, DOS batch files have 
been the mainstay of command-line productivity since 
they first arrived on the scene in 1981 with PC-DOS 1.0. 

Scores of magazine articles and books have been de¬ 
voted to the “how to” of batch programming. Despite 
this wealth of information, a few dark and mysterious 
comers remain. In one such corner, you’ll find the IF 
ERRORLEVEL batch subcommand and the exit codes 
it needs to do its job. 

While most of the commands that make up the batch 
language are easy to understand, many DOS users find 
the IF ERRORLEVEL subcommand elusive. In this ar¬ 
ticle I’ll show you how to use IF ERRORLEVEL within 
your batch files, talk about some of its limitations, and 
give you a list of the DOS commands that generate the 
exit codes that support it. 

What Are Exit Codes? 

DOS provides a way for telling you how successfully a 
batch file has done its work by checking for errors, or, 
that is, it verifies the success of an operation. It does so 


r between zero and 

2b b g erate.’ by some of DOS’s external commands. 
Tnis code can assure you that a fresh disk was format¬ 
ted correctly, or tell you that you have named the wrong 
PATH when replacing files from one directory to anoth¬ 
er. A DOS batch file can report on these errors by em¬ 
ploying the IF ERRORLEVEL command. This IF ER¬ 
RORLEVEL command can change the course of your 
batch file’s action depending on its interpretation of an 
exit code. 

Exit codes are generated by some of DOS’s external 
commands such as FORMAT and XCOPY. Typically, 
these DOS commands are found in your DOS directory 
as stand-alone utilities. (For a list of these, see the table 
“MS-DOS Commands That Supply Exit Codes.”) For 
example, you cannot use the IF ERRORLEVEL com¬ 
mand in batch files that employ only internal com¬ 
mands, such as COPY, DEL, MKDIR (MD), and so on; 
these commands are not programs in their own right, 
and they do not pass exit codes to DOS. 

The IF ERRORLEVEL command does its work by 
“testing” for the appearance of various exit codes as 
your batch file proceeds. In the following FORMAT 
batch file, IF ERRORLEVEL evaluates the exit code re¬ 
turned by the DOS FORMAT utility. By interpreting 
the exit code, it can prevent XCOPY from attempting to 
copy files to a disk that isn’t formatted properly. 

8ECH0 OFF 

FORMAT B: 

IF ERRORLEVEL 5 GOTO NO PROCEED 
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IF ERRORLEVEL 4 GOTO STOPPED 
IF ERRORLEVEL 3 GOTO CTRL_C 
XCOPY A:\*.* B: 

GOTO ENDIT 

:NO_PROCEED 

ECHO No files were copied. Disk formatting 

ECHO was aborted. 

GOTO ENDIT 

:STOPPED 

ECHO No files were copied. The FORMAT program 

ECHO has stopped. 

GOTO ENDIT 

:CTRL_C 

ECHO No files were copied. You pressed Ctrl-C. 

:END_IT 


In English, the first line means: IF the ERRORLEV¬ 
EL (exit code) is equal to or greater than 2, execute the 
portion of the statement that appears to the right of 
the numeral 2. Here, the statement portion tells the 
DOS batch interpreter to branch to (GOTO) the label 
ENDIT. 

IF ERRORLEVEL is called a conditional batch com¬ 
mand, because the right portion is acted upon only 
when a predefined set of conditions is satisfied. A condi¬ 
tional statement that can pass this test of “equality” is 
logically true. 

Here’s another way to evaluate the same command: 
IF the ERRORLEVEL is less than 2, don’t execute the 
portion of the command that appears to the right of the 
numeral 2. When a conditional statement fails the test 
of “equality,” it is logically false. 

By convention, DOS programs that set exit codes al¬ 
ways return a value of zero when an operation is suc- 
ctssfu Error messages are always assigned a number 


If you’re not acquainted with ER¬ 
RORLEVEL, this simple batch file 
probably raises numerous questions 
How does ERRORLEVEL know when 
FORMAT terminates with an error? 
Can it determine the exact error? Tb 
clarify matters, let me show you what 
goes on behind the scenes. 

How ERRORLEVEL Works 

When DOS receives an exit code from 
an external DOS program, it stores 
the code number in a data area re¬ 
served for exit code information. 
When you query ERRORLEVEL, by 
including the command in your batch 
file, the DOS batch interpreter re¬ 
trieves the most recent exit code 
stored in the ERRORLEVEL data 
area. Next, the interpreter determines 
the “level” of the exit code by compar¬ 
ing it with a value you specify. A typi¬ 
cal sequence might look like this: 

IF ERRORLEVEL 2 GOTO ENDIT 

REM More batch commands here 

:ENDIT 


j&'Sffe MORE OF AUTO- 

and confjg.sys 

Do you often edit your AUTOEXEC.BAT or CONFIG.SYS files? 

This is no problem when you're in the DOS editor or a word 
processor. But have you ever needed to alter just one line and 
didn’t have an editor handy? You can use a combination of the 
COPY and CON commands to accomplish this. 

Here’s how to do it with AUTOEXEC.BAT. First, type: 

COPY C:\AUTOEXEC.BAT + CON 

press Enter and you’ll see the following commands: 

AUTOEXEC.BAT 

CON 

Add the new line or lines, pressing Enter after each one. Finally, 
press F6 and Enter. 

To use the same technique with CONFIG.SYS, follow the steps 
above, substituting CONFIG.SYS for AUTOEXEC.BAT. 

—Kay Yarborough Nelson 
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MS-DOS COMMANDS THAT SUPPLY EXIT CODES 

The only MS-DOS commands that return exit codes are its external programs: BACKUP, DISKCOMP, DISKCOPY, 
FORMAT. GRAFTABL. KEYB, REPLACE, RESTORE, SETVER, and XCOPY. You should note, however, that most 
equivalent PC-DOS commands do not support exit codes. 

The following table lists the MS-DOS commands mentioned above and explains the meaning of eacfi command’s 
exit codes 


DOS 

Exit 

Code 

DOS 

Exit 

Code 

Command 

Code 

Meaning 

Command 

Code 

Meaning 

BACKUP 

0 

All files backed up. Normal exit. 

REPLACE 

0 

Files replaced or added. Normal exit. 


1 

No files found to back up 


2 

No files affected Source file not found. 


2 

Not all files backed up. Sharing 


3 

No files affected. Source or target path 



conflict exists. 



not found. 


3 

User pressed Ctrl-C. 


5 

Read/write file access denied. At least 


4 

Error Program has stopped, 



one file 

was not replaced. Use ATTRIB to change 

DISKCOMP 

0 

Disks are the same. Normal exit. 



the file-access level. 


1 

Disks are not the same 


8 

Not enough memory to run command. 


2 

User pressed Ctrl-C 


11 

Bao parameter or invalid format. 


3 

Hardware (disk) error. 





4 

Initialization error 

RESTORE 

0 

Fiies restored. Normal exit. 





1 

No tiles found to restore. 

DISKCOPY 

0 

Disk copied successfully 


3 

User pressed Clrl-C. 



Normal exit. 


4 

Error occurred Command interrupted. 


1 

Nonfatal read/write error during 
copying 

SETVER* 

0 

Opmation successful. Normal exit. 


2 

User pressed Ctrl-C 


1 

Invalid switch 


3 

Fatal hardware error 


2 

Invalid filename. 


4 

Initialization error. 


3 

Not enough memory. 





4 

Wrong version-number format. 

FORMAT 

0 

Disk formatted successfully. 


5 

Entry not found in version table. 



Normal exit 


6 

DOS system requested not found. 


3 

User pressed Ctrl-C. 


7 

Invalid drive. 


4 

Error. Program has stopped 


8 

Too many parameters. 


5 

N pressed in response to 


9 

Missing parameter. 



“Proceed with format (Y/N)?" 


10 

Error reading SETVER EXE file. 



prompt. 


11 

Version table is corrupt. 

GRAFTABL 




12 

Specified SETVER.EXE doesn't support 

0 

Character table loaded. Normal exit. 



version tables. 


1 

Character table replaced former table. 


13 

No space left in version table. 


2 

Table not loaded File I/O error 


14 

Error writing to version table. 


3 

Incorrect parameter. 




4* 

Not DOS 5 

XCOPY** 

0 

Specified files copied 

KEYB 

0 



1 

No files found to copy. 

Keyboard file loaded Normal exit 


2 

User pressed Ctrl-C. 


1 

2 

Bad keyboard code, code page, or syntax. 
Bad keyboard-definition file 


4 

Not enough memory or disk space, 
syntax error, or initialization error. 


4 

CON device error 




5 

Requested code page not prepared. 





'Applies only to MS-DOS 5 0 

-See table Update MS-DOS XCOPY and Its Exit Codes 
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greater than zero. 

The IF ERRORLEVEL command may also contain 
the NOT operator: 

IF NOT ERRORLEVEL 2 GOTO DOJT 

This option reverses the logic. A translation for the 
line above is: IF the ERRORLEVEL is not equal to or 
greater than 2, execute the GOTO DO_IT command 
and proceed with the next statement in the batch file. 

A second way to interpret the line is: If the ER¬ 
RORLEVEL is 2 or greater, skip the GOTO 
DO_IT command. 

The following batch file fragment provides an 
example of how to use IF NOT ERRORLEVEL: 

IF NOT ERRORLEVEL 1 GOTO DO IT 
ECHO A program error has occurred 
GOTO ENDIT 
:D0_IT 

REM More batch commands here 

:ENDIT 

In this example, IF the ERRORLEVEL is 1 or 
greater, the GOTO DO_IT command is not execut¬ 
ed, and the batch file continues with the ECHO 
statement in the second line. However, IF the ER¬ 
RORLEVEL is 0, the batch file executes the 
GOTO DO_IT command and branches to tb< 
:DO_IT label, skipping the second and third line- 
of the batch file. 

This general form of IF NOT ERRORLEVEI i 
useful when you want to carry out one set of 
batch commands when a DOS command has suc¬ 
cessfully completed its task (that is, the ERROR 
LEVEL is 0), or a second set of commands when 
an error has occurred (that is, the ERRORLEVEL 
is 1 or greater). 

Watch Those Levels! 

An important point to remember about IF ER¬ 
RORLEVEL is the way in which the batch inter¬ 
preter evaluates exit codes: The evaluation is 
based upon ERRORLEVEL being equal to or 
greater than the number you supply for compari¬ 
son. Remember that the batch interpreter tests 
the exit code for an error level, not a specific num¬ 
ber value. 

To illustrate this point, here is a sample batch 
file to evaluate the ERRORLEVEL passed from a 
program. This one tests the exit code for more 
than one condition: 

REM KEY TO EXIT CODES: 

REM 1 = Disk media error 
REM 2 * File not found 
REM 4 = Bad filename 


IF ERRORLEVEL 1 GOTO MEDIAJRROR 
IF ERRORLEVEL 2 GOTO N0_FILE 
IF ERRORLEVEL 4 GOTO BADFILE 

Assume the value of ERRORLEVEL passed to the 
batch file was 2. According to the exit code key, a “file 
not found” error has occurred. However, as the batch in¬ 
terpreter executes the file, it evaluates all the lines, 
from beginning to end. In this case, the interpreter will 
select incorrectly: 


Program Listing. VC0PY.BAT uses IF ERRORLEVEL and XCOPY exit codes 
to verify the success of transferring files from a source directory (%1) 
to a target directory (%2) 

@ECH0 OFF 

ip „ %r 3S G0TQ NO j RC 

IF «%2" *= ■" GOTO NOJEST 
XCOPY HI H2 

IF ERRORLEVEL 4 GOTO CATCH-ALL 
IF ERRORLEVEL 2 GOTO CTRL_C 
IF ERRORLEVEL 1 GOTO N0_FILES 
IF ERRORLEVEL 0 GOTO SUCCESS 

:CATCH_ALL 

ECHO One of the following errors has occurred: 

ECHO. 

ECHO 1. There is not enough memory to copy the files. 
ECHO 2. You specifieG a drive that doesn't exist 
ECHO 3. You mistyped the source/destination pathname. 
GOTO ENOJT 

:SUCCESS 

ECHO FHes in %I were copied to HI 
GOTO ENDJT 

:N0JILES 

ECHO The source directory %1 either doesn’t exist 
ECHO or contains no files to copy. 

GOTO ENDJT 

:N0_SRC 

ECHO You did not specify a source directory. 

GOTO ENDJT 

:N0_DEST 

ECHO You did not specify a destination directory. 
GOTO ENDJT 

:CTRL_C 

ECHO The program stopped because you pressed Ctrl-C. 

: ENDJT 

End 
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IF ERRORLEVEl 1 GOTO MEDIA_ERROR 

because this line passes the test of “equality” — the 
number 2 is equal to or greater than 1. In batch 
files that test ERRORLEVEL for multiple condi¬ 
tions, you can avoid this problem if you remember 
to arrange your IF ERRORLEVEL subcommands 
to test the highest exit codes first: 

IF ERRORLEVEL 4 GOTO BADJILE 
IF ERRORLEVEL 2 GOTO NOJILE 
IF ERRORLEVEL 1 GOTO MEDIAJRROR 

By arranging the commands in this way, you pre¬ 
vent the batch interpreter from branching to an in¬ 
correct label or returning an inaccurate result. 

One for the Road 

HI leave you with a batch file that uses IF ERROR- 
LEVEL in a practical way. The Program Listing. 
VCOPY.BAT, uses the XCOPY command to transfer 
all files that reside in the source directory (Vc 1) to 
the target directory ( %2). The IF ERRORLEVEl 
commands receive exit code information from 
XCOPY.EXE. After XCOPY terminates, the ba’oh 
file reports any errors that occur or teds you the op¬ 
eration was a success. 

You can type in VCOPY.BAT using Edim, Edit - DOS 
5.0), or any word processor that saves files in ASCII for¬ 
mat. Save the batch file as VCOPY.BAT, then type: 


UPDATE: MS-DOS XCOPY 
AND ITS EXIT CODES 

The following table, provided by Microsoft Corp., shows how 
XCOPY exit codes have changed in MS-DOS versions 3.20, 


3 21,3.30,3.30a, and 4 01 


Meaning Of 
Exit Code 

4.01 


File not found 0 

User terminated 2 

Insufficient disk space 0 

Invalid path or 4 

Invalid drive 

specification 4 

Successful 0 


DOS Versions 
And Exit Codes 

3.30a 3.30 3.21 3.20 

0 0 11 

0 0 2 2 

4 4 4 4 

4 4 4 4 

4 4 4 4 

0 0 0 0 


Hate to MS 003 5.0 XCOPY USERS 

Re i .dfeFs or // th 4S-D03 5. nanoa 1 says, exit code 5 does 
^ COP v ir; ve . on 5 0 DOS Microsoft did, however, 

reins’ats ex:t ^ 1—t rio* f ounc 


Be su: <.* to specify pathnames when appropriate.) 

To copy all files in the C:\WP\LETTERS directory to 
a floppy dibk in drive A. you would type: 


VC0PY source file target file 


til J A SPEEDY RECOVERY 

When you install new software, you often are asked to make a 
directory on your hard drive, then copy all the files from the 
program s floppy disk to this directory. How often have you created 
the directory and then proceeded to copy the files into your root 
directory or another incorrect directory? It can prove quite a chore 
to delete all those files without erasing the files that really belong 
there. 

I’ve found a way to make this type of cleanup operation simpler. 
First, log onto the drive containing the floppy whose files you just 
copied to the wrong directory, then type a command like the 
following: 

FOR %A IN (*.*) DO 0EL C:\WR0NGDIR\%A 

The command goes through the files on the floppy disk one by 
one, deleting any matching files it finds in the directory you 
mention 

—David Oatley 


VC0PY C:\PW\LETTERS A: 

Before you start VCOPY.BAT, make 
sure the directory in which you’ve 
stored XCOPY.EXE is included in the 
PATH statement of your AUTO¬ 
EXEC.BAT file. XCOPY.EXE is normal¬ 
ly found in your C:\DOS directory, 
which is usually included in your PATH 
statement. An XCOPY batch file is an 
especially good example of IF ERROR- 
LEVEL and its use of exit codes, be¬ 
cause Microsoft has changed the exit 
codes returned by this command from 
one DOS version to the next. (See table: 
“Update.MS-DOS XCOPY AND ITS 
EXIT CODES. ) Using a XCOPY batch 
file also gives DOS Resource Guide a 
chance to set the record straight about 
a misprint in the DOS 5.0 reference 
manual. ■ 

John Wolfskill is o free lance writer and 
president of Powertrain Development He 
is a technical editor of DOS Resource 
Guide. 
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PART III: PROGRAM IN DEBUG 


Write Your Own 
Debug Utilities 

With a crash course in the fundamentals, you can start creating 
Debug scripts just like the ones in magazines. 


by Dan Gookin 


ebug, DOS's cryptic programming «rviro'i- 
ment, most often rears its ugly hoci:- * 
those eye-straining magazine scripts that 
let you make small, handy utilities. O: 
course, such articles never explain how the scripts were 
designed or how Debug can be useful in creating other, 
similar programs. 

In an effort to be less snobbish than other magazine 
writers, Fve tried in this series to demystify Debug so 
that anyone can begin to use it with confidence. In the 
previous two installments, we explored the origin of 
Debug, the basics of hexadecimal notation and memory 
addresses, “peeking" and “poking" through memory, 
and working with disks. In this part, I’ll make the time 
you’ve invested worthwhile by showing you step-by- 
step how I wrote a short Debug script that adds a greet¬ 
ing to your DOS prompt. You then can apply the princi¬ 
ples learned to your own experiments in Debug 
programming. 

Speak Microprocessor Like a Native 

Believe it or not, programming isn’t as difficult as it 
sounds. Anyone who can follow directions can pro¬ 
gram. In fact, I Find reading needlepoint or crocheting 
instructions more difficult than programming a com¬ 
puter. (Then again, I’m odd.) 

Tb program a computer using Debug or assembly lan¬ 


guage, you store and manipulate values in the micro¬ 
processor’s registers. TTiese are tiny, high-speed storage 
places inside the microprocessor itself. You can manipu- 
la • the registers directly by using assembly language, 
i b*s is the lowest and, I admit, most complex way to 
program a imputer. Better programming languages 
are r sfiv >.aick Basic, which use English-like com- 
lnan > to idiomatically carry out the intricate and 
time-cons nr.uig task of telling the microprocessor what 
to do. In Debug, however, we’re stuck with assembly 
language. 

Just as you used Debug in earlier parts of this series 
to look at a chunk of random-access memory (RAM), 
you also can employ it to peer into your microprocessor. 

'type DEBUG at the DOS prompt and. at Debug's hy¬ 
phen prompt, type R (the Register command), then 
press Enter. You’ll see something on your screen that 
resembles the screen shown in the box titled “The View' 
From Within." 

As I’m sure you’ve guessed, this screen display shows 
your microprocessor’s registers, which are displayed in 
typically obscure, Debug-like format. (The picture actu¬ 
ally shows 8088-compatible registers. The more power¬ 
ful 80286-and-later microprocessors have more regis¬ 
ters than those Debug knows about. ) 

Using the box as a guide, locate your microprocessors 
registers. First in line are the four general-purpose reg¬ 
isters: AX, BX, CX, and I)X. You can change the values 
in these registers for any purpose; they aren’t restricted 
to a specific use. 

The SP register, on the other hand, specifically indi- 
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C:NDOS>deb«iq 


TH€ VIEW FROM WITHIN 
Debug's R command displays the contents of 
your microprocessor's registers, which you 
can manipulate with Debug's command-line 
language. (See the hex “All About Registers" 
lor an explanation of each register's 
purpose.) The third line of the display shows 
the beginning memory location (in this case, 
2E95:01Q0) of the program currently running, 
followed by the machine-language program 
code itself, in hexadecimal. This lowest-level 
code is then shown translated into higher- 
level assembly language, with its English-like 
commands. 


SF FFEE OF 0000 SI HHHH DI MMHB 


AX -0000 BX 0000 CX 0000 DX 0000 -- mu up pi pi na Pft Nr 

SS-30B? CS 3BB7 IP-0100 HU UP El PI. HZ HA PO HC 

ADD AL.IBX*SI*E73EI DS E/3E 


DS-30B7 ES-38B? 

3087:0100 02803EE7 


_ 


cates the size of the microprocessor’s stack segment.—a 
place usually employed temporarily to store the ad¬ 
dresses of subroutines. The BP, SI. and DI registers like¬ 
wise are special-purpose registers: BP generally stores 
addresses moved over from the stack, while SI and L)1 
most often contain program data. Note how Debug lists 
each register by name and includes a four-digit hexadec¬ 
imal (hex) number showing the valiu stored in each sin¬ 
ister. (For a complete explanation of each register's pur¬ 
pose, see the box “All About Registers ”) 

On the second line, you'll see the four segment regis¬ 
ters: DS, ES, SS, and CS. DS and ES store the RAM ad¬ 
dresses of miscellaneous data items, w hile CS specifi¬ 
cally identifies the program code’s starting address, and 
SS, the stack’s address. Next comes the IP register, or 
instruction pointer. It tells the microprocessor where to 
find its instructions in memory'. Currently the instruc¬ 
tion pointer is looking at address 100 hex. 

To the right of IP are flags: bit locations inside a spe¬ 
cial register that tell the microprocessor the results of 
certain operations. For example, the NZ flag (in the mid¬ 
dle) is tt up”—that is, the bit value it represents is 1— 
whenever you add two values together and the result is 
Not Zero; if the result is zero, the flag is “down” and 


reads ZR. This and the other flags let you perform sim¬ 
ple if-then tests on numbers you add or compare in the 
microprocessor—really teensy, tiny stuff, but that’s how 
the mic’Tjpro-. essor land assembly language) works. 

The i bird me shows ou the execution address where 
Di bug : per d to run a program. This address is a 
"i.tik ; v location, which insists of a segment (a four- 
i ; ' V n; mber specifying each 1 6-byte chunk of mem- 
> i on i* f 'tsct jur digits that locate the exact byte 

it he segment, is 
cant; n ri in the «’S (code segment) register, as seen in 
ime 1 wo of the display. The offset is the value in the IP 
jgister. I .e byte or bytes at that location appear next 
to the address on the third line of the register display. 

Next to the execution address, you'll find one or more 
bytes—a string of hex numbers running together. These 
are machine-language instructions for the microproces¬ 
sor. The instructions then are translated into an assem¬ 
bly-language code or mnemonic at the end of the third 
line. The mnemonic appears as a two- to five-letter word 
followed by an optional value or, maybe, the names of 
one or two registers. Believe it or not, this is English- 
like text that explains what the machine-language com¬ 
mand is instructing the microprocessor to do. 

(You’ll be hopelessly lost if 
you don’t know about back- 
words storage, another one 
of those strange conventions 
that makes working under 
your PC’s hood much harder 
than it should be. The com¬ 
puter reverses the logical or¬ 
der of the two-digit hex 
translation of any item that 
is more than one byte long. 
Thus, the two-byte hex value 
3EE7 is actually stored in 
memory as E73E, and it ap¬ 
pears that way in any dis¬ 
play that gives you a direct 


A NOTE ON DEBUG SCRIPT FORMATS 

Like many computer magazines, DOS Resource Guide publishes some of its tips 
and utilities in the form ot Debug programs. These Debug listings, or scripts, 
contain a combination of assembly-language mnemonics and Debug commands. 
Other magazines publish scripts coded predominantly in hexadecimal numbers, a 
lower-level translation that is harder to read than assembly language 
We’ll continue to run Debug scripts in assembly language, because we think 
they are easier to type in and modify than all-hex scripts. They also lend 
themselves to step-by-step tutorials explaining how they work. 

—Eds. 
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“dump” of memory. To prove 
this for yourself, refer back to 
the register display and com¬ 
pare the machine language 
immediately next to the seg¬ 
ment/offset code on line three 
with the assembly language 
translation to the right of it. 
Notice how some of the hex 
characters are reversed? 

Incidentally, the back- 
words principle holds true for 
longer data items. Tb get the 
hang of reading them, always 
remember to read from right 
to left two hex digits at a 
time.) 

Don’t be confused by all 
this. For now, just read it 
and look engrossed so that 
anyone watching you will as¬ 
sume you’re a computer ge¬ 
nius. Everything will make 
more sense when you start 
putting values into the regis¬ 
ters and telling the micro¬ 
processor what to do with 
them. 

Programming the 
Microprocessor 

Since the microprocessor 
works with RAM as well as 
with its own registers, you 
can put something interest¬ 
ing into RAM by typing the 
following: 

E10A "I told the 
microprocessor to do this.S" 


ALL ABOUT REGISTERS 

Registers are 16-bit storage areas inside the microprocessor itself Debug can 
access the 14 registers of the 8086/8088 microprocessor, whose structure is 
emulated by all of its successors, from the 80286 to the 80486. (However, the later 
chips have additional registers unavailable to Debug ) 

Some registers listed as general-purpose actually have alternative uses that 
require a detailed knowledge of assembly language. Omitted in this chart is the 
14th, or flags, register, which uses nine of its 16 bits to indicate the results of 
certain mathematical and program-control operations. You can find an explanation 
of the flags register in any assembly-language programming manual and in other 
easily available reference books for programmers 

SCRATCH PAD REGISTERS 

AX (Accumulator) As one of the so-called scratch pad registers, it can be used 

as temporary storage for any kind of operation. Typically, however, it stores the j 
results of arithmetic operations, especially multiplication and division, which 
are prohibited in other registers. You can break AX and the other scratch pad 
registers into two 8-bit registers; in this case, AL ( L for /ow) and AH {high). 

BX (Base) Can point to, or store, the memory address of a special data table in 
memory You can also use it to hold the offset half of a segmented address. 

CX (Count) Can store the repetition counter for instructions that loop, or repeat 

OX (Data) Can contain the remamder of division operations performed in AX, 
among its specialized uses. 

SEGMENT REGISTERS 

C$ (Code $fegr«K r t) As: -e. of iou r registt s intended for holding the segment 
haif of a memo • address .i identifies the starting segment in memory of the 
program cunently running. rP contains (he offset 

DS (Data Segment) One of two registers (with ES) for storing the segment 
identifier of data used in the mam program 

ES (Extra Segment) One of two registers (with DS) for storing the segment 
identifier of data used in the main program. 

SS (Stack Segment) Identifies the segment where the stack, a special 
temporary storage place, resides in memory. 

OFFSET REGISTERS 


This pokes a string of text 
into memory starting at loca¬ 
tion 10A hex. Make sure that 
the string ends with a dollar 
sign and is enclosed in double 
quotes. (DOS looks for the 
dollar sign to find the end of 
the string.) If you’d like a 
more meaningful phrase, 
such as “Hello” or “Cut down 
on saturated fats,” to greet 
you at the DOS prompt, just 
type it in between the first 
quote mark and the dollar 
sign. 

Just as you’ve poked values 


IP (Instruction Pointer) As one of the five registers intended tor holding the 

offset half of a memory address, it identifies the offset for the program that is 
currently running. CS stores the segment portion of the program's address 

SP (Stack Pointer) Indicates the memory location of the top of the stack, a 
temporary storage place. 

BP (Base Pointer) Contains the latest memory address added to the stack, 
which uses the addresses as reference points to subroutines. 

SI (Source Index) As one of the two index registers (with Dl), it is used 

primarily for addressing program data, although you also can use it for any 
purpose you choose. 

Dl (Destination Index) Like SI, a general-purpose register that is most-often 

used for addressing program data. 
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into memory, you now can use the R command to put 
values into the microprocessor’s registers. R must be 
followed by the name of the register. For example, type 
in the following to change the value in the AX register: 

RAX 

As a result. Debug displays the current value in the 
AX register: 

AX 0000 

then prompts you for input. Type in a new value of 900 
hex, as shown here, and press Enter: 

: 900 

The following command puts the value 10A hex into 

the DX register: 

RDX 
: 10A 

Now you need to poke some microprocessor instruc¬ 


tions into memory. Use the E (Enter) command as in 
the following: 

E100 CO 21 

Here, Debug pokes the CD 21 instruction into memo¬ 
ry at address 100 hex. This instruction is called an in¬ 
terrupt. Its assembly-language mnemonic is INT 21, 
which you can see by typing the R command and look¬ 
ing at the screen. Note the values of the AX and DX 
registers as well as the current instruction. 

What you’ve just done is to prime the pump for writ¬ 
ing a computer program. Tb “run” this program, type the 
P command. (P stands for Proceed.) You’ll see your mes¬ 
sage on the screen, followed by another register display. 

Here’s how it worked. The CD 21, or INT 21 hex, in¬ 
struction tells the microprocessor to execute a DOS 
function call, which is a section of DOS code that does 
a small but important job. such as closing a file or 
choosing a disk drive. The function is selected by load¬ 
ing the AX register with 900 hex, which is the “Output 
character string" command. DOS displays the charac- 
ter string starting at the memory location specified in 
th register. That location. 10A hex, was filled with 
lext by the E command. 


GQw 


FINDING YOUR 
WAY THROUGH FILES 


I download many files from my local BBS. If 1 wish to, say, look at the 
names and descnptions of all files pertaining to Pascal, using a word 
processor is time-consuming. Not only that, but my word processor 
automatically fills my directory with BAK files. DOS 5.0's improved FIND 
command is a simpler solution. 

If I want to search a file downloaded earlier named FILES.BBS and that 
file is located on drive B, I simply type. 


FIND /N /I "PASCAL" B:FILES.BBS 


Bv the w y, you’ll find all of this 
formation in any DOS program- 
mi ig manual. It will list all the 
function calls by number and tell 
you which microprocessor regis¬ 
ters need to be loaded with which 
values to make everything work. 
Of course, “real” assembly-lan¬ 
guage programmers don’t poke in 
values piecemeal. They use a tool 
called a compiler—a program 
that translates higher-level 
“English” code into lower-level 
bits. Debug comes with one of 
those as well. 


The /N switch tells DOS to display the line number in which each 
occurrence of the designated text string (the word PASCAL) appears. The 
ignore-case switch, /I, is a new feature in DOS 5.0; it ensures that my 
search will find this string whether it appears as pascal, Pascal, or 
PASCAL 

If many Pascal files turn up, the output may stream up and off the 
monitor faster than I can read it. I get around this problem by redirecting 
the monitor output to a file for later editing with a comand such as this: 

FIND /N /I -PASCAL" B:FILES.BBS>B:PASCAL.RJB 

The greater-than sign (>) redirects the output from the screen to a file 
named PASCAL.RJB, which is located on drive B. The extension RJB is 
composed of my initials, which I often use because they are easy for me 
to see on a directory listing. 

—Robert J. Batterberry 


The Assembly-Language 
Translation 

Debug’s mini-compiler lets you 
type in assembly-language mne¬ 
monics, which Debug translates 
into programming instructions 
for the microprocessor. This is the 
secret behind many of the Debug 
scripts you find in computer mag¬ 
azines. 

Tb activate Dehug’s assembler, 
type A and press Enter. You’ll see 
the following: 

xxxx:0100 

Debug is now' in assembly 
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mode, awaiting your instructions. These instructions 
will be stored at address 100 hex; the xxxx } shown 
above, is the segment address, which will vary from PC 
to PC. Type in the following assembly-language instruc¬ 
tions, starting at address 100 hex. (Debug will auto¬ 
matically advance you to the next offset.) Press Enter 
after each line: 


xxxx:0100 MOV AX,900 
xxxx:0103 MOV 0X.10A 
xxxx:0106 INT 21 
xxxx:0108 INT 20 
xxxx:010A 


E10A M I told the microprocessor to do th1s.$“ 
A 

MOV AX,900 
MOV DX.10A 
INT 21 
INT 20 

RCX 

30 

N HELL0.C0M 
W 

Q 


On the last line, press Enter by itself to exit the mini¬ 
assembly mode. Here is a translation of what you 

typed: 

MOV AX,900 Put, or "move," 900 hex into the AX register. 
MOV DX,10A Put 10A hex into the DX register. 

INT 21 Call interrupt 21 hex, a DOS function call. 

INT 20 Call interrupt 20 hex; end this program. 


Remember. Debug uses hexadecimal numbers; 900 is 
really 900 hex (2,304 decimal). The MOV mnemonic 
loads registers just as did the Rva: command. Above, 
you typed INT 21 and INT 20. instead of poking in the 
machine-language instructions. 

This program will perform ;n the 
same way as it did when you poked i:i 
everything manually. In fact, you could 
type G (the Go command i »i ,ht now 
and run the program. But why nei 
something more? TVpe in the following 
commands: 


Note the blank line between INT 20 and RCX; it ends 
input in Debug’s assembly mode. You can enter these 
keystrokes into a word processor or text editor and save 
them as an ASCII file, such as HELLO.SCR. Then you 
can spoon them to Debug via DOS’s I/O redirection 
command: 

C:\> DEBUG < HELLO.SCR 

The result is the file HELLO.COM. (Some magazines 
may use the E command exclusively to poke in bytes in¬ 
stead of using the assembler. The result is the same.) 

Writing trie script outside of Debug minimizes the 
risk of mistyping something and having to start all 
over. Since most magazines writers instill a fear of 


.0 'i' SCOTER WAY. PERIOD 

■ As you probaoly know, you can change to a higher directory level 


RCX 

cx oooo 

: 30 

N HELL0.C0M 

W 

Q 

The RCX command tells Debug that 
the file size is 30 hex bytes. N names 
the file HELLO.COM, W writes it to 
disk, and Q quits Debug. You now have 
a program file on disk, called 
HELLO.COM. Type HELLO at the 
DOS prompt to see what happens. Then 
give yourself a treat, because you’ve 
just written a program in Debug. 

This is essentially how the Debug 
scripts that you find in magazines 
work. For example, the above exercise 
might appear as the following Debug 
script file: 


i 


by typing CD.. at the DOS prompt. If you’re in 
C:\DOCS\REPORTS\AUG, for example, issuing this command 
takes you to C:\DOCS\REPORTS. 

You also can use double periods as shorthand for long 
pathnames. For example, if you are in C:\DOCS\REPORTS\AUG, 
you can use the following command to go a directory two levels 
above your present branch (C:\DOCS): 

CD .A.. 

But putting double periods to work your AUTOEXEC.BATs 
PATH statement can really make life simpler. For example, if you 
want to perform handy single-level and double-level jumps include 
the following at the beginning of your PATH statement: 

Whenever you’re in a directory, the directory one level or two 
levels above is available in your path. Therefore, if you’re in 
C:\DOCS\REPORTS\AUG, C:\DOCS is in your path. When you 
switch to C:\LOTUS\SHEETS\FEB, C:\LOTUS is in your path. 

—Kay Yarborough Nelson 
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Debug into your bones, this must be their logic; and it 
does make creating the file easier. 

Debug as Debugger 

Debug’s name implies that it can remove bugs from a 
program. It lets you do this by tracing through a pro¬ 
gram s instructions one step at a time. You actually can 
see the instructions affecting the microprocessor and 
memory using the R, D, and the T or P commands. (But 
Debug makes this awkward. Other debuggers, such as 
Microsoft’s CodeView and Borland's TurboDebug, do a 
much better job.) Nevertheless, here's how it works. 

Reactivate Debug, and load the program by entering 
the following at the DOS prompt: 


DEBUG HELLO.COM 

At Debugs hyphen prompt, type R and press Enter to 
see the register display. Look at the instruction shown 
at the bottom of the display: 

MOV AX,0900 

Now type T to trace program execution. You’ll see the 
same register display, but note the AX register. See how 
900 hex was loaded into it? The next instruction loads 
10A hex into the DX register. Type T and press Enter to 
confirm. 

The next instruction is INT 21. lb execute an INT in¬ 
struction, you must use the P command. (Otherwise the 
T command traces you through 
the bowels of DOS—which could 
take hours inside Debug.) Type P 
to process the INT 21 instruction. 
Your message will appear on 



MOVING FILES 
UNKNOWN ORIGIN 


If you have gotten any mileage out of the DOS 5.0 shell, you may have 
noticed some curious batch files cropping up in your DOS directory. 

These electronic gremlins go by monikers such as A2EDOSC.BAT or 
????DOSC.BAT, and they’re generated in a couple of ways Sometimes 
they appear when you use a batch file to run an application from the shell 
instead of running the application itself. The shell also creates temporary 
files—which normally are removed—but they can be left hanging around, 
if you have to resort to pressing Ctrl-Alt-Del to reboot To get rid of files 
such as these, I’ve altered my AUTOEXEC BAT file 
When you set up DOS 5.0, the operating system puts a statement like 
the following into your AUTOEXEC.BAT file: 

SET TEMP=C:\D0$ 

This tells DOS to put temporary files of the sort mentioned earlier into 
your \DOS directory. However, to avoid cluttenng your \DOS directory, 
you can give these files a directory of their own, called TEMP, one level 
below the root directory. (To do this, use DOS’s Make Directory command 
to create the \TEMP subdirectory: MD \TEMP.) Then, alter the above 
sequence in your AUTOEXEC.BAT to read: 

SET TEMP=C:\TEMP 

You then can add a DEL command to rid your system of the unwanted 
files automatically the next time you boot up. Simply insert the following 
line just below the SET TEMP line: 

ECHO Y1 DEL C:\TEMP\*.* 

The first part of this line, ECHO Y, acts as a reply (in the affirmative) to 
DOS’s “Are you sure?" deletion warning, thus automating the process. 

The second part of the command, C:\TEMP\*.*, directs DOS to delete 
the files in the TEMP directory. 

—Legare Coleman 


screen. 

The final instruction is also an 
nteraipt, INT 20. TVpe P again, 
and you’]] see "Program termi¬ 
nal normally.” Ta-da! You’re all 
done Type Q to exit Debug. 

Debugging programs lets you 
see i they work, how they af¬ 
fect the microprocessor’s regis¬ 
ters. and how they interact with 
the i*est of the PC. But debugging 
requires a knowledge of computer 
programming and using DOS’s 
internal function calls and BIOS 
calls. This quickly dismisses any 
chance of debugging, say, COM¬ 
MAND.COM or WIN.EXE to 
learn their magic. Yet it does give 
you a hint as to Debug's power. 

I hope you’ve enjoyed this se¬ 
ries on Debug. As long as you 
avoid using the W command to 
write random blocks of memory 
to disk and carelessly poking 
with the E command, you should 
feel free to let Debug help you ex¬ 
amine the innermost workings of 
your PC. ■ 


Dan Gookin is the author of the 
best selling book DOS for Dummies 
{IDG Rooks). His Supercharging 
MS-DOS (Microsoft Pressl contains 
more tricks and hints on using 
r DOS. 
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Advanced Batch Files? 
No Problem! 

Here’s how to make your batch files accept parameters, use GOTOs, 
test for conditions, and handle errors. 


by Hardin Brothers 


ast issue, I explained the theory behind 
batch files and the simplest commands: 
REM, PAUSE, ECHO, and C\I,L. This 
time, I’ll look at mo r e advanced ommands 
that normally are used only in batch files ll also ex¬ 
plain two other DOS features you’ll necv to wtko r.s ill 
and advanced batch files. 

Shifty Command-Line Parameters 

A batch file can accept parameters you supply at he 
DOS prompt. That is, you can type its name, followed 
by words or numbers, and the batch file will accept 
those characters for its owti use. It receives parameters 
in variables numbered from % 1 to %9. 

To see these parameters at work, create the following 
batch file, and name it TEST.BAT: 

PECHO OFF 

ECHO Parameter 1 is HI 
ECHO Parameter 2 is %2 
ECHO Parameter 3 is %3 

(The @ symbol suppresses the ECHO OFF message in 
DOS 3.3 and later versions. Eliminate @ if you are us¬ 
ing a version earlier than DOS 3.3.) Save TEST.BAT, 

and test it by typing: 

TEST Abel Baker Charlie 

Try TEST.BAT with your own parameters. Use no pa¬ 
rameters or more than three. 

January 1993 


By convention, the seldom-used command-line pa¬ 
rameter %0 contains a batch file’s name. You can add 
the following line to TEST.BAT to see it in action: 

ECHO This file's name is HO 

You car, change the parameter-numbering scheme in- 
oide a batch file w a command called SHIFT. This 
command moves each parameter down one number: The 
contents of r r: are moved to ^0, of Vc2 to %1, of %3 to 
and so on. SHIFT is a useful command if your batch 
file expects r.ore thi n nine parameters or if it contains 
loops. You can re write TEST.BAT this way to use the 
SHI FI 1 command: 


@ECH0 OFF 




ECHO Parameter 

1 

is 

HI 

SHIFT 




ECHO Parameter 

2 

is 

%1 

SHIFT 




ECHO Parameter 

3 

is 



Jumping Around 

Normally, a batch file executes one line at a time, from 
the beginning of the file to the end. The GOTO com¬ 
mand lets you repeat some parts of the batch file or 
skip others. 

GOTO is always followed by a one-word label—the 
name of the line that executes next. The named line 
must contain only the label name preceded by a colon. 
One simple (and useless) example should make the use 
of GOTO clear. The following batch file will display a 
message on the screen until the user presses Ctrl-C or 
Ctrl-Break. Any other keystroke causes the program to 
display the message again: 
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0ECHO OFF 

CLS 

:LOOP 

ECHO Press Ctrl-C to end or 


PAUSE 
GOTO LOOP 


simple to be useful and safe) version of a short batch 
file, called MOVE.BAT: 

REM Use: MOVE source destination 
OECHO OFF 
COPY HI %2 
IF EXIST %2 DEL HI 


The real power of GOTO is not to perform trivial 
loops such as this one but to branch to different parts of 
a batch file as the need arises. Such branches almost al¬ 
ways are based on the results of a test. 

Passing the Test 

Batch files can make tests and act on the results of 
those tests with the help of the IF command. IF has six 
general syntactic forms: 

IF EXIST filename command 
IF NOT EXIST filename command 

IF stringl string2 command 
IF NOT stringl = c string2 command 

IF ERRORLEVEL nnn command 
IF NOT ERRORLEVEL nnn command 


The program assumes that you will type a command 

such as: 

MOVE ABC.DAT A:ABC.DAT 

to move a file from the current directory to drive A. It 
begins by copying the file from the source to the desti¬ 
nation. Then it checks to make sure that the destina¬ 
tion exists, which will indicate that the COPY com¬ 
mand executed correctly. If so, it erases the source file. 

If you use the IF NOT EXIST form, then the com¬ 
mand is carried out only if the file cannot be found. Here 
is an equivalent MOVE.BAT demonstration program: 

PECHO OFr 

COPY HI HI. J 

IF NOT EXIST %2 GOTO END 
DEL %1 


In all of these forms, the final command us anything 
that could occur on a line of its own in a batch file, in¬ 
cluding another IF. The only restriction is that all batch 
file lines, like all lines that you type at the DOS 
prompt, must contain fewer than 128 characters. 

The first form (IF EXIST filename command) is proba¬ 
bly the easiest to understand. If a file exists, then the 
command is executed. Otherwise, the command is ig¬ 
nored. The filename can include a drive letter and sub¬ 
directory as well as the name of a file, and it may in¬ 
clude wildcards. For example, here is a simple (too 


: END 

The IF stringl -= string'2 test can determine which 
command- line parameters you’ve entered. For example, 
a menu batch file might have a line like this: 

IF HI == WP GOTO WORDPROC 

The line will jump to a label called WORDPROC if the 
first command-line parameter is WP. The test is sensi¬ 
tive to case, so the program will not operate correctly if 


CgTSlAKE YOUR LAST DRIVE 

■UjJiYOUR LASTDRIVE 

Memory is your PC's most precious commodity. Did you know that 
each drive letter reserved in the LASTDRIVE statement of a 
CONFIG.SYS file lowers the amount of memory available to your 
applications by 176 bytes? If your system has only one hard disk, 
identified as drive C, you should insert the following line in 
CONFIG.SYS: 

LASTDRIVE-C 

This reduces the amount of RAM set aside for reserving drive 
letters in the DOS environment. In fact, anyone with fewer than four 
hard drives will recover additional memory by including the 
appropnate LASTDRIVE statement in CONFIG.SYS. 


you type a command-line parameter of 
wp or Wp. You can overcome this prob¬ 
lem by including an IF line for each pos¬ 
sible combination of uppercase and low¬ 
ercase letters. (I’ll describe a different 
solution below.) Another problem with 
the line is that it doesn’t test to make 
sure any command-line parameters ex¬ 
ist. If you don’t supply a parameter, the 
line will look like this after DOS substi¬ 
tutes a “no-length” string for 9F1: 


IF 3 = WP GOTO WORDPROC 


COMMAND.COM will display a “Syn¬ 
tax e!*ror” message when it tries to exe¬ 
cute the line. In some versions of DOS* 
the batch file will end immediately be¬ 
cause of the error. You can avoid this 
problem by adding one or more charnc- 
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ters to both sides of the “==" sign in the original line. 
The most common solutions look like this: 

IF “%1- -WP" GOTO WORDPROC 
IF %1. •« WP. GOTO WORDPROC 

Both these lines will have characters to compare and 
therefore won’t cause an error, even if you don’t enter 
any command-line parameters. 

Levels of Errors 

For many users, the final two forms of IF seem to cause 
the most confusion. 

Every program sends an exit code to DOS as it ends. 
Many programs use the exit code to relay information 
to DOS; others simply end with a random exit code. 
About a dozen DOS external commands use an exit 
code to report their status as they end (see your DOS 
manual for an explanation of the codes). 

By convention, an exit code of zero means a program 
ended successfully. Other codes from 1 to 255 report dif¬ 
ferent kinds of errors. The meaning of each exit code 
varies from one program to another. In batch files, exit 
codes are called ERRORLEVELs and are tested with 
the IF ERRORLEVEL nnn command form. The nnn can be 
any number from zero to 255. You might expect that 
the line: 

IF ERRORLEVEL 3 GOTO THIRD 

would go to the line called THIRD, if the exit code of the 
last program was 3. It will, but it also will go t that 
line if the exit code was 4, 5, or any othei muni r high 
er than 3. In other words, the test if ERRORLEVEL 
nnn will succeed if the exit code from the last program 
was nnn or higher. 

If you want a batch file to perform a command only if 
the exit code has one specific value, you can use two dif¬ 
ferent strategies. The first is to test first for a higher exit 

code, like this: 

IF ERRORLEVEL 4 GOTO TOOHIGH 
IF ERRORLEVEL 3 GOTO THIRD 
:TOOHIGH 

The second technique you can use is to perform two 

tests in one line: 

IF ERRORLEVEL 3 IF NOT ERRORLEVEL 4 GOTO THIRD 

If you want to test for an exit code of zero, which often 
is used when a program ends successfully, you can’t use 
IF ERRORLEVEL 0. That test always will be true, be¬ 
cause every program returns an exit code of zero or 
more. Instead, insert a line like the following: 

IF NOT ERRORLEVEL 1 GOTO OKAY 


Looping Around 

Perhaps the most underused DOS command, both in¬ 
side and outside of batch files, is FOR...IN...DO. Part of 
its lack of popularity may be the command’s unusual 
syntax and restrictions. Unfortunately, FOR ..IN...DO 
has two different syntactic forms. If you use it from the 
DOS command line, its syntax is: 

FOR Hvariable IN (set) DO command 

In a batch file, however, its format is slightly different: 

FOR \\variable IN (set) DO command 

Be careful always to use the double-percent sign if 
you use this command inside a batch file. The variable 
in FOR . IN.. DO is any single letter. You cannot use a 
numeral for the variable, because a percent sign fol¬ 
lowed by a numeral represents a command-line param¬ 
eter. The command after the word DO is anything that 
could be on a line of its own in a batch file, except for 
another FOR...IN...DO command. 

The most interesting part of FOR...IN...DO is the 
“set” that is contained inside the parentheses. It can be 
any group of strings, filenames, and filenames with 
wildcards. The items must he separated by commas, 
spaces, or tabs. When FOR...IN...DO executes, the com¬ 
mand is run for each member of the set. Each time the 
command executes, the variable is made equal to the 
next member of the set. 

If this seems a little foggy to you, perhaps some ex¬ 
amples will help. Try each of these in a simple batch 
file. Remember, if you want to use them from the com¬ 
mand line, use single percent signs in front of the vari¬ 
able names. Let’s begin with a simple example: 

@ECH0 OFF 

FOR %%X IN (a b c) DO ECHO %%X 

In this example, the variable %9 tX is equated, in 
turn, to each of the members of the set, which are a, 6, 
and c. Each value is displayed on the screen with the 
ECHO command. As this command is executed, you’ll 
see the three letters show up on the screen. 

Try altering the batch file by using longer and short¬ 
er sets, by substituting full words for the individual 
letters in the set, and by separating the elements of 
the set with commas or tabs. When you feel comfort¬ 
able using FOR...IN...DO in this example, its time to 
try something new. 

Before DOS 5.0, there was no simple way to get a di¬ 
rectory listing that could be moved into a program or 
text editor for further processing. Filenames in a direc¬ 
tory listing always were padded with spaces, and the pe¬ 
riods between the filename and extension were missing 
I use the following batch file, called OUTDIR.BAT. to 
prepare a group of filenames for further processing. If 
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you have DOS 5.0, you can do the same thing with the 
command 01R /A-D /B. A simple form of the batch file— 
one that will display all tiles in the current directory — 
looks like this: 

@ECH0 OFF 

FOR *%X IN (*.*) 00 

ECHO %%X 

Try it. then change the file specification inside the 
parentheses to something such as *.TXT. Now try it 
again. Once you understand how OUTDIR.BAT works, 
you can turn it into a useful, full-fledged batch file: 

PECHO OFF 

IF "%1" == "■ GOTO HELP 
IF NOT "%3“ « ■■ GOTO HELP 
IF NOT "%2" « ■" GOTO OUTPUT 
FOR %*X IN (%1) DO ECHO %%X 
GOTO END 
:OUTPUT 

FOR %%X IN (%1) DO ECHO %%X » %2 

GOTO END 
:HELP 

ECHO Create "bare" directory listings 
ECHO Syntax: OUTDIR filespec output 
ECHO sends list of files matching filespec to 
ECHO the output file or device 
: END 

After the ©ECHO OFF statement, the batch file be¬ 
gins with some error checking. If the first command¬ 
line parameter is blank, or if the third parameter isn’t 
blank, the batch file displays a help message and ends. 
If both of these tests are passed, the user typed either 
one or two command-line parameters, and the program 



TYPING FROM 
THE CONSOLE 


If you need to type up a quick note but want to escape 
the drag of loading your word processor, you can make 
your computer into a typewriter simply by entering: 


COPY CON PRN 


at the DOS prompt, then type a message, such as: 

I never thought DOS could be such fun! 

When you're done, press F6 (the end-of-file 
marker) and then Enter. Your message should print 
out, 

—Gloria Short 


proceeds. If the user typed two parameters, the batch 
file sends the directory listing either to a file or a device 
(such as PRN, the printer). 

Ib do that, the batch file jumps down to the label called 
:OUTPUT. If only one command-line parameter exists, it 
is a filename, probably with wildcards, that defines 
which files the user wants to list. The first FOR...IN...DO 
statement creates that list and then jumps down to the 
label called :END to bring the batch file to a halt. If the 
user wants to send the output to a device or file, the sec¬ 
ond FOR...IN...DO does just that. Then, again, the batch 
file jumps to the end and stops. And if the user makes an 
error, the ECHO commands after the label :HELP ex¬ 
plain how the program should be used. 

Even if you are writing batch files for yourself and no 
one else, you should include some error-checking and 
help text. Otherwise, you’ll forget how to use the batch 
file and have to figure it out again someday. 

You may want to employ FOR...IN...DO in two other 
ways. First, I use it in a batch file that runs CHKDSK 
on all of my drives Since my large hard drive is divided 
into four logical partitions, labeled C through F, I use a 
batch file v. ith this line to avoid some typing: 

FOR VX IN (C D i F) DC CHKDSK %*X: 

Another use for FOR ..IN...DO is to avoid repetitive 
checks ( command-line parameters when you want to 
allow any combination of tipper- and lowercase letters. 
For example, you could do this: 

IF %1==WP GOTO W0RDPR0C 
IF %l==wp GOTO W0RDPR0C 
IF %l==Wp GOTO WORDPROC 
IF %l==wP GOTO WORDPROC 

On the other hand, you could save yourself a lot of 
typing and get the same result with this line: 

FOR %%X IN (WP wp Wp wP) IF %*X«%1 GOTO WORDPROC 

Go to It! 

You should have enough skill now to start creating use¬ 
ful batch files of your own. You also should be able to 
understand most of the batch files in this magazine, as 
well as those you find in books and at user’s group 
meetings. 

Next time, 111 look at the last important batch file 
feature and at some other advanced batch-file tech¬ 
niques. I II also show you how to add to the power of 
batch files with utility programs that you can create us¬ 
ing Debug and Basic. ■ 


Free-lance writer Hardin Brothers, who has 6,™ working 
with and writing about computers for 13 years, is a 
technical editor of DOS Resource Guide. 
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Divvying Up 
Your Hard Drive 

Whether you prefer the wide open spaces or like to squeeze 
your data into neat little lots, DOS has strict rules for 
subdividing your prime magnetic real estate. 


by Tom Badgett 


f you’re upgrading to DOS 5.0 or to a larger 
hard drive, an important decision faces you: 
Should you treat the drive as one large fil¬ 
ing cabinet or partition it into smaller ones? 

The choice comes down to more than a matter of per¬ 
sonal preference, because partitioning rules vary 
among DOS versions. All DOSes prior to version 3.3 re¬ 
strict you to a single, 32MB partition, leaving any re¬ 
maining disk space inaccessible—unless you equip your 
system with a utility package that lets you have multi¬ 
ple, large partitions. (Two such programs are listed in 
the box, “Disk Management Software.”) DOS 4.x is the 
first to intrinsically allow multiple partitions, but it 
holds each partition to the old 32MB limit. The cap 
leaps to 2,048MB (or 2 gigabytes) with DOS 5.0. 

If you are among the thousands of users upgrading 
from, say, DOS 3.x to DOS 5.0, doing away with small 
partitions will be time-consuming. The sheer size of 
much of today’s software—especially Windows applica¬ 
tions—eventually may convince you to move to a single 
large partition, but you’ll have to factor in the effort in¬ 
volved. Ultimately, the cost/benefit analysis breaks 
down this way: spend time deleting subdirectories on a 
multiple-partition drive to make room for your largest 
programs, or spend it backing up all your data to floppy 
disks before repartitioning to create a single large 
drive. 

As you can imagine, many more variables come into 


play. This article, arid the accompanying sidebars, will 
help you make a final decision and act on it. 

Partition Definitions 

Disk partitioning is both a physical and a logical 
method of breaking up large hard drives into smaller 
entities. Physically, the partition is magnetically encod¬ 
ed on the disk; logically (or in software terms that DOS 
“understands”), it gets a drive letter assigned to it. DOS 
treats each partition as a separate drive—the first par¬ 
tition is drive C (unless you have another hard drive al¬ 
ready installed), the second partition is D, and so forth. 

To understand partitioning, let’s look at the structure 
of a typical hard drive. The very first section on every 
hard disk is program code called the master boot record 
(MBR), which helps the Basic Input/Output System 
(BIOS), a built-in program that mediates between 
hardware and software, get the computer up and run¬ 
ning when you first turn on the power or press the reset 
button. 

Immediately after the MBR comes the disk partition 
table, a group of data that tells DOS how you have con¬ 
figured the disk using the FDISK utility or a third-par¬ 
ty program. This table shows where each physical par¬ 
tition begins and which partition is the active, or boot, 
partition. 

The third major section of every hard drive is the boot 
sector, or boot record, which stores information about 
the disk partition with which it is associated. Each par¬ 
tition has a boot sector regardless of whether it is a 
bootable partition. The physical location of the boot 
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DISK MANAGEMENT SOFTWARE 


Hard drive software that lets you get around the single-partition limit of OOS 
3 2 and earlier 


record is in the first sector of 
the partition. Thus, on a drive 
thiU has three 32MB partitions 
and uses 1:1 interleaving (that 
is, it locates consecutive storage 
sectors next to each other, 
rather than spacing them apart 
at regular intervals), the boot 
record for the second partition 
is located about 32MB from the 
first track of the disk, and the 
boot record for the third parti¬ 
tion is located about 64MB into 
the drive. 

In addition to the portion of a 
partition that actually stores in¬ 
formation, each partition has 
two more special-purpose areas: 
the file allocation table (FAT) 
and the partition directory. The 
FAT is another table that DOS 
references, this time to deter¬ 
mine which parts of the disk 
are in use and which are avail¬ 
able to hold new data. Because DOS 
doesn’t always store a file in con¬ 
tiguous locations, the FAT also 
tracks where each piece of a given 
file resides. 

The partition directory stores the 


Disk Manager 5.10, $124.95 

Ontrack Computer Systems Inc. 

6321 Bury Dr 

Eden Prairie, MN 55346 

800-752-1333 

612-937-1107 

(outside U S and Canada) 

Allows up to 16 partitions per drive. Lets 
you fully access large drives that exceed 
DOS’s 1.204-cylinder limit. Also 
includes an installation program that 
shields you from DOS’s disk commands, 
as well as diagnostic programs 


names of files and the address at 
which the first part of each file is 
stored. When DOS reads a file, it 
goes to the directory to find out 
where to get the first part; then it 
consults the FAT to find out where 


SpeedStor for DOS, $99.95 

Storage Dimensions Inc. 

1656 McCarthy Blvd. 

Milpitas. CA 95035 
408 954-0710 

Lets you install as many as 24 partitions 
(which also is DOS 5.0's limit). Key fea¬ 
tures include auto-installation and com¬ 
prehensive diagnostics. 


the next part is stored. 

Because the data in the FAT is so 
important, DOS maintains two 
copies of it FAT1 and FAT2 for each 
partition are next to each other in 
the first sector of the partition. 
When DOS starts up, a copy of the 
FAT for each logical or physical 
drive is loaded into memory for 
quick access. 

One or Many? 

What’s the best partition strategy 
for a computer running DOS 5.0? 
All things being equal, the best ad¬ 
vice of the experts is to use one 
large partition. You still can use 
several small partitions under DOS 
5.0 if you want to, and doing away 
with existing multiple partitions 
may not be worth the hassle. But 
generally, there is little reason to 
break up a drive. That’s the consen¬ 
sus of a number of experienced MIS 
managers and power users in pub¬ 
lishing, manufacturing, insurance, 
and engineering. 

The main reason to use one large 
partition is simplicity, particularly 
when you start using Windows and 
Windows applications. These are 
big programs that can quickly fill 
up a partition. 


How Basic Can You Get? 

If you have DOS, you have a version of Basic, the most popular program¬ 
ming language in the world. And, as an enthusiast who likes to get down 
to fundamentals, you’ve probably written a program or two—be it a 
quickie dashed off to solve a printing problem or a menu-driven home 
finance program that took weeks to perfect. 

We’d like to see the short Basic programs you’re most proud of. They 
must be 100 or fewer lines and written (or rewritten) in QBasic, the Quick 
Basic interpreter that comes with DOS 5.0. Include a brief explanation of 
how each program works. We’ll print the best ones in a new column in 
DOS Resource Guide. We’re partial to short listings that solve a com¬ 
puting problem or overcome DOS’s limitations, rather than application 
software. 

Send your QBasic programs, each with a 
brief explanation of how it works, to: 

DOS Resource Guide 

80 Elm St 

Peterborough, NH 03458 

Or upload the files to our on-line addresses: 

CompuServe (75300,2361 > 

MCI Mail (469-7260) 


J 

— 
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SIX REASONS TO PARTITION (EVEN IF YOU DON’T HAVE TO) 


As a DOS 5.0 user, you’re no longer encumbered by 
the 32MB partition limit of previous DOS versions, 
but you still may have reasons to ignore experts’ 
advice and install multiple hard drive partitions 
Among the rationales for multiple partitions are: 

• Non-DOS-compatible disk management. No 

current version of DOS fully supports a hard drive with 
more than 1,024 cylinders. If you are using one of the 
many drives configured with more cylinders than that, 
you won't be able to access the parts of your disk that 
are located beyond cylinder 1,024. You can use a third- 
party disk manager and break up the drive into multiple 
partitions, however. This is one of the most common 
reasons for using more than one partition on a large 
hard drive 

• Backup management. If you are using a 40MB or 
80MB removable hard drive as a backup device, you 
might find it convenient to establish partitions that are 
multiples of this capacity. One 40MB partition or two 
20MB partitions should fit on a single 40MB removable 
cartridge, for example. Th : s lets you conveniently use 
XCOPY to back up an entire system to a torn 

be transported to another computer or re * nred \ f : 
source or to any other directory o n your ov. na -r,t 
You can do the same with subdirectory struct,., o:, 

•Portable software cr data. The need io- moving 

software or data to various machines can be facilitated 
by partitions small enough to fit on a single removable 
platter. This is a personal preference issue that can n 
fact, cause extra problems. Some software maintains 
configuration files that keep track of where everything 
is, for example. If you move an application to another 
computer, you might not get it to run without making 
sure the subdirectory and drive names are the same as 
those that contained the original files. 

•Applications management. Some people find it 

easier to keep one application and its data in a separate 
partition with its own drive letter assignment. Drive D can 


be your database program, for example, drive E your word 
processor, and so on. Moreover many applications store 
information about the current installation: which drive and 
subdirectory is in use and so on If you do away with mul¬ 
tiple partitions and try to copy installed software back to 
the hard drive, some programs may not run without being 
reinstalled or reconfigured to reflect the new drive config¬ 
uration. The process could be time-consuming 

• Data security. The separate FAT entries created dur¬ 
ing partitioning and stored at several locations on the 
drive may offer a slight security advantage If a glitch 
damages information for one partition, chances are good 
that you still can access data in the other partitions. 

For the most part, however, partitioning won’t help 
much with a damaged disk. If the damage is in the 
partition table itself, for example, you won’t be able to 
read anything on the disk Ultimately, the best security 
strategy is to maintain current backups. 

• Faster data access. This is a real stretch, but you 
get a slight speed advantage when you break up a large 
drive with many files into several subdisks with fewer 
files on each If you use applications that search multi¬ 
ple drives during operation, however, the speed advan¬ 
tage is probably lost 

Depending on how you use your disk, smaller 
partitions may reduce the time the drive’s read/write 
head takes to scan the disk. If you load and run an 
application program that uses only the current 
partition, DOS wili load its associated files faster 
simply because the disk-reading mechanism travels a 
shorter distance than usual. 

Practically, though, whatever slight speed advantage 
you might gain from smaller partitions doesn’t 
outweigh the benefits of the single large partition. 

—T.B. 


Here’s a good example of why it’s 
best to have one partition. Suppose 
you have three 40MB partitions on 
a 120MB disk. You have used the 
drive for some time and already 
have installed a number of large ap¬ 
plications and associated data. 
Suppose one partition has 10MB of 


free space, another has 8MB, and a 
third has 6MB free. 

Now you want to install a new 
program (with optional utilities and 
a tutorial) that requires 12MB of 
free disk space. Obviously, you have 
plenty of free space on the disk (10 
+ 8 + 6 = 24MB), but no single parti¬ 


tion has enough room to hold the 
new software. Your only course of 
action is deleting enough data in 
one partition to make room for the 
new software. But if the disk were 
configured with one large partition, 
you would have 12MB of storage 
space w ithout changing anything 
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HANDLING PROBLEM INSTALLATIONS 

Although DOS 5.0 is easier to install than any previous 
version, certain hard drive configurations can slow 
down the setup process. 

One problem you are likely to have is upgrading to 
DOS 5.0 from an earlier version of DOS on a hard drive 
that was configured with a third-party disk manager or 
a utility that came with your computer. The partition 
information from these products —particularly on 
drives that contain more than 1,024 cylinders—almost 
always is incompatible with DOS 5 0. Software 
companies have upgraded their disk managers to be 
DOS 5.0 compatible, however, so all you need to do to 
keep the current partitions is upgrade the disk 
management software. 

You still may be able to get DOS 5 0 up and running, 
even if you don’t have an upgraded disk manager DOS 
5.0 will install itself automatically on the first DOS 
partition on the specified drive and likely will function 
without problems However when you try to access 
subsequent partitions—the ones created by the third- 
party software—DOS 5.0 won’t recognize the 
partitioning and the computer will hang ud. 

With third-party disk partitioning software other than 
Ontrack’s Disk Manager, you’ll have to ask the 
manufacturer for an updated version that is compatible 
with DOS 5.0 Because Disk Manager is the most 
common program of its type updates for it are included 
in the MS-DOS 5.0 upgrade box. DOS's Setup program 
even handles the Disk Manager upgrade for you. 

This automatic update is performed only with the 
DOS 5.0 Upgrade Kit, which you can order from 
Microsoft for $99.95 at 800-642-7676 (though it’s 
generally cheaper in retail outlets). If you buy another 
version of DOS 5.0, such as one supplied by a 


computer vendor, you may have to handle the 
installation yourself. Here’s how: 

• Use the EXPAND utility to copy DMDRVE.BL and 
XBIOS OV_ from the DOS distribution disk to your hard 
drive. These files are on distribution disk 6. 

• Name the expanded files DMDRVR.BIN and 
XBIOS.OVL. The full command line sequence, if you are 
using drive A as the source and storing the files in the 
root directory, is: 

EXPAND A:\DMDRIVE.BI_ C:\DMDRIVE.BIN 
EXPAND A:\XBI0S.0V_ C:\XBI0S.0VL 

• Run Setup with the /U switch: 

SETUP /U. 

You might encounter additional problems with some 
If Setup detects that you are 
df vi( ( d as SQDRIVER.SYS 

for Sy quest removable hard drives), the program halts, 
reporting the presence of an incompatible device 
drive r . (It’s )atch-22 DOS itself will accept the driver, 
but Setup won t ) Simply use a word processor or other 
editor to remove the DEVICE line from your 
CONFIG SYS file (or you can add a REM command in 
front of the line to disable it). Now rerun Setup and 
upgrade to DOS 5 0 After installation is complete, you 
can put the driver back into CONFIG.SYS or remove 
the REM statement from the line. 

— T.B. 


It comes down to personal prefer¬ 
ence, of course, but most users also 
find it easier to manage one large 
disk than several smaller ones. 
When you are looking for a file, for 
example, you probably will find it 
more quickly if you know that it is 
on drive C than if you have to 
search four or more drives. 

On the other hand, staying with a 
partitioned drive when you upgrade 
to DOS 5.0 can seem like the path of 
least resistance. In general, if you 
are upgrading from an earlier DOS 
version that did not support parti¬ 
tion* larger than 32MB, your large 


hard drive already is segmented 
into multiple partitions. DOS 5.0s 
Setup utility will install the operat¬ 
ing system upgrade without chang¬ 
ing the current partitioning data. 
This is the fastest way to get DOS 
5.0 up and running. If you later de¬ 
cide to you want a single partition, 
you can repartition the disk. [For 
further discussion on bucking the 
conventional wisdom, read the side- 
bar, “Six Reasons to Partition (Even 
If You Don’t Have Tb).”J 
But even if you decide to stay 
with multiple partitions when you 
move up to DOS 5.0, you may have 


to do some repartitioning. With 
DOS 3.x, many users were in the 
habit of creating a single, 1.2MB 
partition to hold DOS and other 
boot software. The theory was that 
you could back up all the required 
boot information to a single floppy* 
DOS 5.0, however, requires at 
least 2.8MB to store the whole sys¬ 
tem, so a 4MB first partition is a 
more appropriate size and allows 
some room for growth. You can put 
the basic files you need to boot DOS 
and to conduct a few DOS opera¬ 
tions in less space, of course, but to 
have access to all DOS facilities in 
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one place, plan on 3-^lMB. 

One for All 

In my view, the best all-around con¬ 
figuration is a single large partition, 
especially if you’re starting with a 
new (and therefore empty) hard 
disk. Under DOS 5.0, the process 


involves just six steps (some com¬ 
puter vendors offer DOS 5.0 ver¬ 
sions that perform several steps au¬ 
tomatically): 

• Boot the computer from the sup¬ 
plied floppy containing DOS 5.0. 

• Run the DOS FDISK utility and 
choose option 1 (“Create DOS 


Partition or Logical DOS Drive*! 
from the menu. 

• Choose option 1 (“Create Primary 
DOS Partition”) from the next 
menu. Specify that you want to use 
all available disk space at the next 
prompt and exit FDISK. 

• Run FORMAT from the DOS 5.0 


BACKUP BASICS: PAYING ATTENTION PAYS OFF 


If you plan to consolidate an existing drive’s multiple 
partitions into a single partition, you’ll need to back up 
all of the programs and data that you want to carry over 
to the new setup. DOS 5.0, like the DOS versions before 
it, makes all data on a repartitioned drive inaccessible. 

Backing up and restoring data should be a regular 
part of your computing regimen and deserves a 
separate, much larger article of its own. For now, here’s 
what you need to know about backing up before 
repartitioning your hard drive 
DOS comes with a primitive but relatively effective 
backup facility in the paired programs BACKUP and 
RESTORE. The BACKUP utility copies the specified files 
or directories to a floppy drive. Even if a single file is 
too large to fit on a single floppy, BACKUP can 
compress and copy the file across multiple disks. The 
key to success with BACK oppy 

disks in order. They are numb )reo 1 ihr • ;gh th 
maximum number required to ci/ Jin * backup. 

|n addition you must 

logbook noting which directories are m which backup 
disks Unfortunately the REST 3RC w 
must use to copy information from a set of bac 
floppies to a hard disk, can returf files only to the 

original directory 

Therefore, if you back up files from 
C:\WP51\LETTERS, for example, you can return those 
files only to the same directory. Even if you decide to 
restructure a new hard disk and want to use the files in a 
BACKUP archive, you must create the same directory 
structure you had on the old disk to get the data off the 
floppies and onto the hard drive. You then can redesign 
the directory structure and copy the files over from one 
hard drive location to another. But you can't RESTORE 
files from a floppy disk and place them in a different 
directory from the one in which they originated. 

RESTORE will create the required directory structure 
for you if you start the program from the root directory 
of your hard drive and use the IS (subdirectory) switch: 

restore /s 


If you start RESTORE from a subdirectory, DOS isn’t 
smart enough to know there are directories above the 
current one, and it won’t create the proper 
subdirectories for your restored data 
The good news is that even if you are using an early 
version of DOS, using BACKUP and RESTORE during 
the upgrade to DOS 5.0 poses little danger. Microsoft 
officials have stated that as long as you are using DOS 
3.1 or later, no incompatibility problems should crop up 
between BACKUP and RESTORE 
If you use DOS 2 11 or another early version to back 
up your files you can’t use Version 5.0’s RESTORE 
command. Instead, you must find a computer running 
Version 2.11 (or the DOS version you have), restore 
your data, then use COPY or a third-party utility such as 
The Software Link’s LANIink, Fifth Generation Software’s 
Brooklyn Bridge, or Traveling Software’s Laplink to 
move the information rc your DOS 5 0 machine. 

To use BACKUP and RESTORE during an upgrade to 
DOS 5.0 or as your permanent backup solution, first 
• stimate the number of disks required for backup and 
iabc! them. You may want to maintain separate sets of 
floppies for difterent subdirectories or applications. One 
set could hold your word processing programs and 
oata another vour database, and so on. 

Next, run BACKUP, specifying the source and 
destination drives to start the backup. The following 
command, for example: 

BACKUP C: A: 

backs up the current directory on hard drive C to a 
floppy disk in drive A. To back up the current directory 
and any subordinate directories, add the /S switch 
Thus, the command: 

BACKUP C: A: /S 

backs up all files in the current directory and any 
subdirectories that are beneath the current one. 

When each disk is full, BACKUP asks for another 

Continued on page 40 
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floppy with the command FORMAT C: 
$. This “high level" program pre¬ 
pares the partition for use by DOS. 

• Use Setup from your DOS 5.0 in¬ 
stallation disk to install the operat¬ 
ing system on the hard drive. 

• Design and create a directory 
structure for the disk and install 
your software and data. 


Removing existing partitions to 
create one large partition is a little 
more time-consuming, but not all 
that difficult. (You will have addi¬ 
tional problems if you are using a 
third-party disk manager or if your 
drive contains more than 1,024 cylin¬ 
ders. See the sidebar, “Handling 
Problem Installations,” for advice.) 


Here’s the process: 

• Bock up everything on the drive 
(see the sidebar “Backup Basica; 
Paying Attention Pays Off”). 

• Use FDISK to specify a different 
partition scheme. First use selection 
3 (“Delete partition or logical DOS 
Drive”) from the menu. You’ll need 
to use this option once for each par- 


Continued from pjge 39 

floppy. Insert it in the drive and press any key to continue 
Be sure to label the disk just filled with the proper number 
and directory information to make using RESTORE easier 

Finally, store the backup disks in a safe place. It is good 
practice to maintain at least two sets of backup disks. One 
set holds the most current data and the second set holds 
the previous backup. You might store the most current set 
near your computer and the previous set at another 
location, such as in another office building or at home. 
The next time you back up data, use the older set of 
floppies, moving the most recent set to the off-site 
I location. 

To use RESTORE, start by assembling the backup disk 
| set you want to use and inserting the first disk in the 
series into a drive. Make the root directory o f your h ard 
! drive the current directory by typing CD\ and pressing 

j Enter. 

Run RESTORE with ihe source and tar--et crive 
designations to start the restoration. For example the 

command: 

RESTORE A: C: 

restores on drive C backup files from floppy disks in drive 
A Add the /S switch to restore ail subdirectories on the 
backup set. RESTORE asks for each disk as required. 

You can use a number of additional switches to 
j customize the restoration process. You might add an /M 
switch, for instance, to restore only those files modified 
since the last backup, or you can use /N to restore only 
the files that no longer exist on the target (destination) 
drive. (This is useful when you are restoring an older 
backup, and you don’t want to replace anything that might 
still be on the hard drive.) Refer to your DOS manual for a 
complete list of RESTORE’S switches 

It should be obvious that backing up large amounts of 
data can require numerous floppy disks and that DOS’s 
utilities for backing up and restoring are not too user 
friendly. For serious backup requirements—very large 
drives, heavy activity with a lot of changeable data, 
multiple hard drives in a single group or department— 
you should consider a third-party backup utility such as 
PC Fullbak* or Fastback instead of BACKUP and 


RESTORE. They are more versatile and easier to use than 

the integral DOS facilities. 

You also might consider additional backup methods for 
large hard drives. The most convenient is to connect two 
or more machines with a full-time or temporary network 
(Novell. LANLink, LANsmart_ and so on), then simply 
copy information from machine to machine The easiest 
way to make this method work is to maintain both (or all) 
machines with identical directory and file structures. 

When machines stand alone, or when individuals in an 
office or work group are involved in vastly different 
activities, use a removable hard drive (such as the 
Syquest SQ-55) or a high-density floppy such as the 
Bernou i drive from Iomega Systems These units 
typically store 40-80MB n each removable platter, 
making it easy tc back up individual programs, 

j also can use a 

rr press on faci! PK l\P from PKWare Inc. J ] 

- . as much as 90 

percent with such progress. i 

The XCOPY Alternative 

me DOS XCOPY command with its /M switch also is an 
excellent backup and archiving tool, especially for a 1 
removable hard drive or second hard drive. It doesn’t 
compress data, so storage requirements can be large, but 
it produces an archive that is in DOS format, which means 
you can copy individual files or directories to any location 
on any hard drive J 

To use XCOPY for a comprehensive hard drive backup, 
make the root directory the default or current directory 
(Type CD\ and press Enter from wherever you are in the 
directory structure), then type: 

ATTRIB +A *.* /S 

providing an appropriate pathname to tell DOS where 
ATTRIB EXE resides. This sequence of commands resets 
the archive bit for all directory entries on the drive, later 
causing XCOPY to process every file on the disk or 
directory you access. When ATTRIB is finished issue this 
command: 

XCOPY *.* [ pathname ] /M 
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tition installed on your drive. Then 
choose menu item 1 to create a new, 
large partition. 

# Run FORMAT (FORMAT C:) to pre¬ 
pare the partition For DOS. 

# Use Setup on your DOS 5.0 disk 
to install the operating system. 

# Copy everything back to the hard 
disk after DOS is installed. 


You Make the Call 

Luckily, the latest DOS is flexible 
enough to let you have it your 
way—one partition or many. Given 
the size of modern software, you 
should use a single large partition 
whenever possible. Still, the ulti¬ 
mate answer to the u one or many” 
partition question is ruled by excep¬ 


tions. The overview provided here 
should help you decide which ap¬ 
proach is best for your situation. ■ 

Tom Badgett is a principal of Word 
Association Inc., a consortium of high- 
tech writers, and author of DOS 5 
Survival Guide (John Wiley & Sons 
Inc., 1991). 


The /M switch tells XCOPY to reset the archive bit in 
the directory entries for each file it successfully copies 
When the destination drive fills up (if you are using a 
drive with smaller capacity than your source drive). DOS 
displays an "Insufficient Disk Space" message At this 
point, select another drive or put in another cartridge, 
and issue the same XCOPY command 
The /M ensures XCOPY won’t copy the files it copied 
previously, so it picks up where it left off. This way, you 


can fill up successive disks with files until everything on 
your drive is backed up. 

A final word of caution: If you have any files that are 
too large to fit on a single disk, you can’t back them up 
this way. You’ll have to use another utility that can spread 
a single file across more than one disk. 

——T.B. 



Back-lt 4, $99.95 

Gazelle Systems Inc. 

305 N 500 W. 

Provo. UT 84601 

800- 786-3278 

801- 377-1288 

Claims support for w des . r 
tape backup devices. CaL 
sior shrinks fil s 

percent of their original si e. n ceding 

up backup time. 


Central Point Backup 7.1, $129 
Central Point Software Inc. 

15220 N.W. Greenbrier Parkway. 

Suite 200 

Beaverton. OR 97006 

800-445-4208 

503-690-8088 

Standout features are tape backup 
capability and virus detection. 
Package includes both DOS and 
Windows versions. 


COREfast 2.0, $99 

Core International Inc 
7171 N. Federal Highway 
Boca Raton. FL 33487 
407-997-6055 


Automatically verifies accuracy of 
backup copies. Data compression lets 
you squeeze up to 40 percent more 
data onto backup disks 


Fastoack Plus 3.1, 

Fifth Gener non Systen 
10049 N Reiger Read 
Raton Rouge. LA 7G80S 
800-225-2775 
504-29^-7221 

"Snapshot' feature records the file 
and directory structure of the hard 
drive on any given day, letting you 
later restore old drive setups. Works 
with QIC-standard tape drives. 


The Norton Backup 2.0 
for DOS, $129 

Symantec Corp 
10201 Torre Ave 
Cupertino. CA 95014 
800-441-7234 
408-252-3570 

Uses the same clean-looking screen 
menus of Norton’s family of utilities. 
Reads and writes data simultaneously 
to speed up the backup process. 






PC-Fu!!bak+ 2.03, S99 

Westlake Data Corp. 

PO. Box "711 
•Vjstin, TX 78767 
800-876-7824 
512 328-1041 

Lotus-style menus Compare 
.Mi*y lets vou verify accuracy of 
backup cooles. 


SRBack for DOS 3.03, $99 

SitBack Technologies Inc. 

9290 Bond. Suite 104 
Overland Park. KS 66214 
800-873-7482 
913-894-0808 

Operates in background, letting you 
continue other work Works with any 
storage device that DOS can recog¬ 
nize. including Bernoulli and optica! 
drives. 
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BUCK THE TREND! 
STAY WITH DOS 

Subscribe NOW and get 6 issues of DOS 
RESOURCE GUIDE for $23.70.*Save a buck an 
issue off the newsstand price! 


If you're having trouble 
understanding DOS, stop 
worrying. It's not you! 

Understanding DOS is the key to 
effective PC-computing. But if 
you've tried to learn DOS on your 
own, wrestled with its manual, 
purchased a guidebook, or taken a 
course, you're probably still 
frustrated and confused. 

Relax, you're not alone! 

One estimate puts the number of 
DOS-run computers in the 
marketplace at 1Z million But 
how many DOS expert < are there? 

Dam few, and here'** hy 

Since late 1980 Micro*!* C>»p B 
DOS, the essential software 
ingredient of the IBM PC- 
v.,mpatibli has changed manv 
times Along the way the 
operating system that began as 22 
cryptic commands has grown to 
about 100 equally cry ptic 
commands, drivers, and 
programs. 

DOS RESOURCE GUIDE explores 
DOS's hidden secrets, untangles 
he twisted technical prose of 
nanuals, and tells you in clear 
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p r >vyi • capabilities that DOS 
automate tedious 
a ti\ i. \ . such as moving or 
backing up large groups of files. 
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h )<' command line. 

Each issue of DOS RESOURCE - 
GUIDE is filled with tips on using 
i v undocumented shortcuts, 4 
and batch files you can type in and 

use. 
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Use the coupon below, or call: 
800-238-6580 


YES! I'M BUCKING THE TREND! YES! I'M STAYING WITH DOS! 

□YES! Send me 6 Issues of DOS Resource Guide for $23.70.* 
Save me a buck an issue! 

NAME___ M 

ADDRESS 

CITY_ STATE ZIP_ 


(Check, Money Order, or Credit Card—Payment must accompany your order.) 

□ AMEX □ VISA □ MASTERCARD □DISCOVER 

CREDIT CARD #___ M 

EXPIRATION DATE: jM 

SIGNATURE ’ ' .” _ 


MAIL TO: DOS Resource Guide, 80 Elm Street, Peterborough. NH 03458 


In Canada and Mexico pay $29 70. all other foreign (Surface) $41 70 (Air) $53 70 
Checks and money orders must be payable in U S funds, drawn on a U S bank. 
Maryland residents add 5% sales tax 


HV7AD 













The Connoisseur’s 
Shareware Library 

Feel like a shareware simpleton? Here are eight tried-and-true 
programs you should know about. 


by Jacqueline Iimigh 


hoever camp up with the phrase you get 
what you pay for” obviously had no idea 
that shareware one day would appear on 
the scene. By letting you “try before you 
buy,” this breed of software offers a lot of value, primar¬ 
ily because it costs a fraction of what you would pay for 
commercial equivalents. 

Shareware vendors let you use their products—usu¬ 
ally for a month or so, but sometimes for an unlimited 
time—in exchange for nothing more than your unspo¬ 
ken evaluation. If you like the program, you purchase a 
license; if not, you’re honor-bound to stop using the soft¬ 
ware. In either case, you can turn over the program to 
friends, colleagues, family members, or whomever you 
wish for their evaluation: hence the name shareware. 

If you decide to buy, the vendor usually provides free 
technical support, via voice or fax and often by bulletin- 
board system (BBS). Shareware tech support actually 
can be better than what you get from a major software 
bouse, perhaps because shareware vendors are less 
well-known and thus more eager to please. Frequently, 
a printed manual is part of the licensing pact, and some¬ 
times, other perks—ranging from quarterly newsletters 
to discounts on future upgrades—are included. 

More importantly, you’ll be saving money right up- 
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front. In many cases, the price differences between 
shareware and commercial software can be substantial. 
A top DOS-based commercial word processor or spread¬ 
sheet, for instance, can run you $200-$300 at retail, 
but you can license a good shareware equivalent for un¬ 
der $70. 

Not all shareware is created equal, of course. More 
shareware programs disappear into obscurity than 
withstand the test of time, and even the most success¬ 
ful packages can be less than perfect. I’ve compiled a 
list of eight packages that are likely to be on nearly ev¬ 
ery shareware aficionado’s hard drive. These are the 
keepers—near-professional-quality programs that ei¬ 
ther are perennial best-sellers or recent favorites. Most 
are also the top choices of DOS Resource Guide readers 
who responded to a general survey in issue Number 5. 
(Note: All phone numbers listed here are for voice com¬ 
munication, unless otherwise specified.) 

As-Easy-As 

With shareware programs, less is often more. That’s cer¬ 
tainly the case with As-Easy-As, a spreadsheet that can 
run on a PC with just one floppy drive. Although you 
can license As-Easy-As for only $69, the spreadsheet 
still offers plenty in the way of easy-to-use menus, clean 
graphics, and a capable macro-programming language. 

Trius (508-794-9377) began producing As-Easy-As 
back in 1986, and it has been updating the program all 
the way to version 5.01. Evaluation copies are available 
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by direct mail, through approxi¬ 
mately 400 shareware distributors 
and on about 300 on-line services 
and BBSes—including CompuServe 
and a Trius BBS (508-794-0762). A 
286-based IBM-compatible PC run¬ 
ning DOS 2.11 or later is required. 

Commander Keen 

After the intellectually demanding 
business of downloading BBS files 
or installing software from floppies, 
you might be ready for a lighter 
touch. Try the hot new action/adven¬ 
ture game series called Commander 
Keen, where your mission is to res¬ 
cue a group of oracles. 


Apogee (800-426-3123), a share¬ 
ware vendor that specializes in 
games, is pursuing the interesting 
gambit of offering the first disk in 
any Commander Keen set as an 
evaluation copy, but then requiring 
registration for additional install¬ 
ments in the set. For example, with 
Goodbye Galaxy, the most recent re¬ 
lease, you can download the Secret of 
the Oracle episode from Software 
Creations BBS ( 508-365-2359, under 
file section 1), other BBSes, and 
CompuServe, but you have to buy 
both Secret of the Oracle and the 
next installment, Armageddon 
Machine, to move on to the subse¬ 


quent adventure. The duo of disks 

costs $35. 

A 286-based PC or higher, with j 
570K of memory, is recommended. 

And because the applications come 
with sound effects, a SoundBlaster 
or Ad Lib sound card is a big help. 

4DOS (JP Software, 617-646-3975) 
not only resides on BBSes, it was 
born there. Codevelopers Tom 
Rawson and Rex Conn got together 
on CompuServe five years ago and 
didn’t meet in person until just be¬ 
fore the release of the first version of 
their product. A replacement for 


LOOKING INTO SHAREWARE: WHERE TO START 


If you're interested in exploring shareware, them's no 
end of places to start. Shareware sources include 
local, national, and international BBSes PCSIG and 
local user’s groups, national shareware distributors, 
and retail stores, not to mention shareware vendors 
themselves. 

BBSes typically store shareware programs in 
compressed form. You must use a data modem and 

communications software to dial in to a BBS’s 
computer and access the programs you want 

Downloading the programs for evaluation is free, 
except for the access fees sometimes incurred by the 
BBS and the price of the phone call (unless the call is 
to a local or 800 number). 

CompuServe is one on-line service that is well- 
stocked with shareware, but thousands of other 
services throughout the world also carry the programs. 
Some BBSes are run by user’s groups and some by 
shareware vendors, but most are run by outside 
companies and individuals. 

Vendors also distribute shareware on floppies 
directly to customers and through user’s groups, 
shareware distributors, and stores. Pricing policies 
vary, but generally speaking, if you buy the software 
directly from the vendor or through a major software 
chain, you’ll be paying for the price and privilege of a 
license. 

By comparison, if you purchase the floppies through 
a distributor, user's group, or non-software retail outlet 
(such as a video store or supermarket), you’ll probably 
get the same kind of evaluation program you’d obtain 
via modem from a BBS For about $2-$5 per disk, 
you’ll have a chance to try out the program. To receive 
the printed manual and technical support, though, 


you’ll have to buy the license. 

ng to straddle the 

b jfion line, offering shr nk-wrapped editions as 
oppiej The shrink-wrapped versions 
come in ,p * y cellophane-covered boxes, while the 
flappies alt Tied in envelopes or plastic 

bags. 

! f you warn to evaluate shareware before you buy, are 
lying floppies or downloading from a 
BbS 7 The answer depends on your computer 
equipment, DOS expertise, and interest in shareware. 
You may want to buy disks at first if you don’t already 
own a modem and communications software, or if 
you're a DOS novice—unless you’re certain you want 
to make shareware a serious hobby. 

At first glance, the floppies might seem a more 
costly way to go. The difference starts to fade, 
however, when you consider that CompuServe charges 
an $18 hourly access fee during prime time, and a 
one-hour domestic phone call to a vendor-operated 
BBS can cost $15 or more. A 550K file can take more 
than an hour to download when you're using a 2400 
bits-per-second (bps) modem. 

If you do follow the downloading route, you’ll gain 
immediate access to the world of shareware, as well as 
to public-domain software, which carries no licensing 
fee. But you should plan on using a more-expensive 
9600-bps modem, if possible. And because the vast 
majority of BBS shareware programs are compressed 
with PKZIP, if you don’t already know how, you’ll have 
to learn to decompress files with PKZIP—a shareware 
program in its own right 

—J.E. 
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DOS’s COMMAND.COM. this 
ghareware product is meant to let 
you work more efficiently at the 
DOS prompt. 4DOS includes about 
twice as many commands as COM- 
MAND.COM, including a Select 
command that lets you tag certain 
files to be processed by another com¬ 
mand. You also can edit the com¬ 
mand line. 

This past June, Version 4.01 of 
4D0S hit the shareware market, 
bringing greater compatibility with 
OS/2 2.0 and Novell NetWare. Aside 
from CompuServe, main distribu¬ 
tion channels include direct sales, 
software stores, and two other on¬ 
line services: BIX and Channel 1 
BBS. For a $69 licensing fee, you get 
disks, a manual, and a discount on 
the next major release. 4D0S runs 
on any IBM-compatible PC with ei¬ 
ther a hard drive or two floppy 
drives and 512K of RAM. 

PC File 

Like PC Write and Viruscan, this 
database-management program is 
available in shrink-wrapped and 
shareware versions. Buttonware 
(206-454-0479;, the sharew are pow ¬ 
erhouse that makes PC' File, i> tak¬ 
ing a route similar to McAfee’s (the 
ViruScan vendor, below by usin 
major commercial software distrib¬ 
utors to sell the shrink-wrapped bo\ 
to retail stores. Meanw hile, the 
shareware version is being market¬ 
ed through shareware distributors 
and BBSes. 

The commercial and shareware 
PC File are the same products, ex¬ 
cept for their packaging. Each offers 
easy-to-use yet powerful flat-file 
database management (in which 
files aren’t linked to each other), 
along with some simple relational, 
or linking, capabilities. The software 
can exchange data with any other 
program written in DBase and also 
can import Word Perfect merge files 
and comma-delimited files (the lat¬ 
ter conform to a popular file format). 

The shrink-wrapped program 
lists for $149.95, while the licensing 
fee for the shareware version is 
$89.90. Each program requires 


DOS 3.0 or higher, 450K of RAM, 
and 1.5MB of disk space. 

PC Write 

If you’re looking for a low-cost but 
capable word processor, PC Write 
could be the answer. Quicksort, (206- 
282-0452) has designed the product 
to offer the key capabilities of Word 
Perfect and Microsoft Word, while 
leaving out nonessentials and 
adding a few interesting twists. 
Quicksort currently markets four 
versions of the product. The new 
Advanced Level program replaces 
the older Standard Level version 
with a friendlier interface, including 
a new button bar and the ability to 
set custom defaults. 

For a licensing fee of $89, a 
shrink-wrapped copy of PC Write 
comes with an on-line Houghton 


Mifflin thesaurus, a large printed 
manual, one year of tech support, 
and a 20-percent discount on up¬ 
grades. An evaluation disk without 
a thesaurus is available through the 
company for $9 and through other 
channels for varying fees. The eval¬ 
uation copy also can be accessed 
through CompuServe and BBSes. 
System requirements for PC Write 
Advanced Level include DOS 2.0 or 
higher and 448K of RAM, with 
512K recommended. 

PKZIP 

PKZIP from PKWARE (414-354- 
8699) came to the fore in the late 
1980s as a speedier alternative to an 
older program, called ARC. This 
archiving and compression/decom¬ 
pression program is a must if you 
plan to download shareware from 


Shareware Is For Sharing 

Just about the only thing DOS Resource Guide readers like more 
than a good DOS tip is a great bargain on software. And there’s no 
better buy than shareware: software that you try out for free, then 
register for a !; action of the cost of store-bought equivalents. 

Frank!>. we can’t keep up with developments in the grass roots 
world ' : shareware. We need your help. If you Ye using a new 
shareware program that seems to be a cut above the rest, or that 
simply does something unique or interesting, let us know’. We want 
diamonds-in-the-rough—not old favorites like PKZIP and PC File, 
but lesser-known gems with a shot at becoming this year’s hits. 

Send the name of The program, a 500-words-or-less description, 
and where we can find it. to: 

Shareware Editor 

DOS Resource Guide 

80 Elm St. 

Peterborough, NH 03458 

Or use our on-line addresses: 

CompuServe (75300,2361) 

MCI Mail (469-7260) 

Be sure to specify ordering or downloading information, such as a 
BBS number or voice phone number. We’ll also consider public 
domain software, a less common type of software that has no 
license fees. 

DOS Resource Guide will pay $50 for every shareware tip that 
we publish. The money won’t send your kid to college, but it might 
be enough to register the shareware—if you haven’t already. 

v • I - I 
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BBSes You’ll need PKZIP to “unzip” 
the many programs stored in its for¬ 
mat. Some shareware programs, in¬ 
cluding Tblix (discussed next in this 
article), also are archived on floppy 
disks using PKZIP. 

PKZIP is available through a 
company-run BBS (414-354-8670) 
and other BBSes, CompuServe, 
shareware distributors, and user 
groups. (As this issue of DOS 
Resource Guide was going to print, 
Version 2.0 was slated for release by 
the end of 1992.) A $47 registration 
fee gives you a printed manual and 
free upgrade. System requirements 
include DOS 2.0 or higher, 183K of 
RAM. and 149K of hard drive space. 

Telix 

A communications program almost 
always will be lower in price than a 
word processor or spreadsheet, but 
how about one, complete with print¬ 
ed documentation, for only $51? A li¬ 


censed version of Tblix can cost you 
even less—$39—if you’re willing to 
forgo the hard copy. 

Tblix customers range from begin¬ 
ning and intermediate modem users 
to advanced programmers. The 
norices are drawn to a function-key- 
driven, but nonetheless easily com¬ 
prehensible, interface. Program¬ 
mers like the shareware program’s 
extensive scripting language. You 
can check out Tblix through share¬ 
ware distributors, such as Software 
Excitement, by direct mail, or 
through CompuServe or BIX. At 
press time, DeltaComm Develop¬ 
ment (919-460-4556) was scheduled 
to take over responsibility for the 
product from EXIS, the program’s 
original distributor. 

ViruScan 

If you’re using a communications 
program and modem to download 
shareware, don’t you run the risk of 



COMING UP EMPTY 


To delete a directory, it must be empty. For a directory to be truly 
empty, it must be void of everything except the period (.) and double 
period (..) notations that appear at the beginning of every directory 
listing. They are abbreviations for the current directory and the parent 
directory, respectively. 

To delete the files in a directory, you can use the wildcard sequence 
DEL *.*. DOS will ask you to confirm that you really want to do this. 
(Although period and double period entries are included in the total 
count of the files in the directory, they aren’t really files. Thus, this 
command doesn’t delete them.) 

If you delete all the files in a directory (and move out of it, too, since 
you can’t remove the current directory) and still can’t delete the 
directory, it may contain hidden files—perhaps ones you yourself hid, 
ones created by your applications, or hidden system files. If you have 
DOS 5.0, you can find out if hidden files exist by typing: 


DIR /A:H 

To get nd of the hidden or system files that you can’t see, clear their 
attributes with this command: 


ATTRIB -H -R -S *.* 

Then you can change out of the directory and delete it. 


—K.Y.N. 


picking up Black Monday, Pakistani 
Brain, or some other horrendous 
virus? Yes, but probably no more so 
than when you buy standard pack¬ 
aged software. BBS system opera¬ 
tors are keenly aware of viral dan¬ 
gers, and almost all use special 
antiviral software. 

One set of programs, produced by 
McAfee Associates (408-988-3832), 
is available to you straight off 
CompuServe, Internet, or a McAfee- 
maintained BBS (408-988-4004), as 
well as through shareware distribu¬ 
tors. 

ViruScan can detect some 1,300 
known viruses, and a companion 
product. Clean-Up, removes these 
computer germs. Another offering, 
VShield, is a memory-resident pro¬ 
gram that scans your system for 
known and unknown viruses before 
installation, and then continuously 
monitors program load requests 
and system reboots. 

Yearly license fees for home use 
are $25 each for ViruScan and 
VShield and $35 for Clean-Up. 
McAfee has passed responsibility for 
distributing ProScan, a pairing of 
ViruScan and Clean-Up, to K.L. 
Wisner (415-851-3680). This shrink- 
wrapped package uses a colorful, 
menu-oriented screen instead of the 
shareware version’s command-line 
interface. ProScan 3.0, slated for re¬ 
lease in September 1992 at a price of 
$89.95, will bring VShield capabili¬ 
ties, as well as distribution, to retail 
stores through Software Resource. 
Each of the McAfee shareware pro¬ 
grams needs about 320K of RAM. 

This is just a smattering of what’s 
available in the shareware market 
Determine your needs, and don’t be 
afraid to investigate other share¬ 
ware offerings: You’re bound to 
come up with additional finds. ■ 


Free lancer Jacqueline Emigh, based 
in Boston, writes frequently for 
computer publications. She is a 
contributing editor to Newsbytes, an 
on-line news service coloring the 
computer industry. 
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The Big 
Clock 

You can keep better time—and learn a lot about 
programming—by following this complete tour 
through a QBasic program. 


by Alan U Zoichick 


5.0’s QBasic is a fast, sophisticated ian 
Hguage that provides a so»-\;<. editing 
I ■ utility, lets you program n modular and 
reusable) chunks, and has lots of on line 
help. There’s just one problem: Microsoft doesn’t supply 
a manual. 

Thus, to learn more about QBasic, you’ll need to buy 
one of the many references available at your local com¬ 
puter shop or bookstore. Or you can follow along with 
me as I explain the workings of QBOLOCK.BAS, what 
I hope is a useful and interesting QBasic program for 
intermediate programmers. QBCLOCK. BAS exercises 
some of the language’s finer features: error handling, 
modular programming, and graphics support for multi¬ 
ple types of computer displays. 

The program does only one thing: It displays a big 
analog clock in the middle of your screen. The clock 
has a moving seconds indicator, and minute and hour 
hands; they’ll keep accurate time on the screen until 
you press any key to stop the clock. That’s all: no fancy 
graphics, no fancy colors, though I will suggest modifi¬ 
cations that let you add a wide variety of color combi¬ 
nations. 


I’ll explore this program in several ways. First, I’ll 
look at its overall organization. Then, I’ll discuss how 
the program detects different display typos and adapts 


the clock for each type of screen. Finally, 111 present the 
program’s heart-the subroutine that animates the 
hands—and explain the mathematics that makes ev¬ 
erything tick, so to speak. 

The Biq Picture 

The first step in writing a program is to define its major 
tasks—not to decide how those tasks are going to be 
done, but what they are. For QBCLOCK.BAS, here’s 
my first pass at naming the tasks in a kind of to-do list: 

Begin the program. 

1. Figure out what type of screen the computer has. 

2. Based on that information, set the appropriate 
graphics mode. 

3. Draw the face of the clock: outline and tick marks, 
in this simple example. 

4. Draw the part of the clock that changes: the hour 
and minute hands, and a little circle for the seconds. 

5. Wait until the next second comes. 

6. Erase the items drawn in part 4. 

7. Go back to step 4, and keep doing so until the user 
presses a key. 

Exit the program. 

One goal of writing a modular program is creating 
main sections that work independently. Jumping Ixick 
and forth between sections 4, 5, 6, and 7 above is con¬ 
ceptually messy. So, here’s my revised outline, which is 
just a little neater: 
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Begin the propram. 

1. Figure out the screen type. 

2. Set the appropriate graphics 
mode. 

3. Draw the face of the clock. 

4. Repeat steps a-b below until 
the user wants to stop. 

a. Draw the current hour, 
minute, and second 
indicators. 

b. Kill time until the next 
second comes around. 

c. Erase the hour, minute, 
and second indicators. 

Exit the program. 

Now were getting somewhere! 
According to my outline, each of 
the numbered items is indepen¬ 
dent of the other. Therefore, each 
is appropriate for a subprogram , 
a miniature program that is em¬ 
bedded in the body of the main 
program. Subprograms are the 
building blocks of modular pro¬ 
grams: They can be designed, 
programmed, and debugged inde¬ 
pendently; often you don’t have to 
give much thought to how they'll 
interact. 

QBasic allows you to—in fact, 
encourages you to—make each 
menu item a separate modular 
subprogram. (Note that unlike 
line-number-oriented GW-Basic, 
QBasic lets you assign meaning¬ 
ful names to subprograms.) 
Here’s what my first pass at writ¬ 
ing the outline with subprogram 
names looks like: 

Begin QBCLOCK.BAS 

1. Call SetVideoTVpe 

2. Call SetVideoParameters 

3. Call Draw Box 

4. Call TimeLoop 

a. Call DrawHands 

b. Call WaitASecond 

c. Call EraseHands 
End QBCLOCK.BAS 

I’m only going to make two fi¬ 
nal adjustments to the outline be¬ 
fore I begin writing the subpro¬ 
grams. Because drawing and 
erasing the clock hands really 
uses the same operations, with 
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TINKERING HINT #1: GRAPHIC CURIOSITY 

You can modify QBCLOCK BAS to see what the clock looks like in a video mode 
other than the black-and-white one automatically selected by the program 
The main program uses the SetVideoType subprogram to identify the graphics 
adapter In the main module, locate and temporarily replace the CALL to 
SetVideoType with a remark statement: 

REM CALL SetVideoType(VideoTypeS) 

Now add the following line immediately below: 


VideoTypeS a "EGA" 

Press Shift-F5 to run the program You’ll see the clock displayed in the new, lower 

resolution mode. 

To see how the clock looks in CGA graphics mode, modify the new line to read: 


VideoTypeS = "CGA" 

To restore QBCLOCK BAS to its original condition, remove the REM statement, 
then delete the extra line 


TINKERING HINT #2: ADDING COL CD 

QBCLOCK BAS (!. , c’ock in black and white regardless of whether the com- 

uMter is in CCA. EGA or .GA ,ode. Bringing color to the display involves adding 
color commands at several places in the program 
First, some background, in the original main module, the following constants 
determine the deck’s colors 

DrawBlack = 0 ’ Black (background color) 

DrawWhite = 7 ' Gray (hour markers) 

DrawBright = 15 ' White (base and clock hands) 

Higher up in the module, the statement 


COMMON SHARED Radian, DrawBright, DrawWhite, DrawBlack 

allows all program modules to share the new color variables. You change screen col¬ 
ors by changing the value of these variables. 

You must add a new subprogram to change the screen background color on VGA 
adapters. You’ll also need to add new COLOR and PALETTE statements to handle 
background color changes for CGA and EGA adapters. 

To begin work on the new subprogram, add the following line immediately below 
the group of DECLARE sfatements at the top of the main module: 

DECLARE SUB SetRGB (Red, Green, Blue) 

Locate the following CALL statement in the main module: 


CALL SetVideoParameters(VideoTypeS, VideoX, VideoY, VideoAspect) 

Do not modify the line Instead, add the following lines immediately below it: 
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jf videoTypeS ■ “VGA" 
DrawWhite * 7 
OrawBright - 15 
Red * 4 
Green j 30 
Blue * 44 
CALL SetRGB(Red, 

END IF 

If VideoTypeS = "EGA 
OrawWhite =15 
DrawBnght = 14 
Background = 4 
PALETTE 0, Background 
END IF 

IF VideoTypeS 
DrawWhi te 
OrawBright * 2 
Background = 4 
COLOR Background 
END IF 


THEN 


set the clock hour mark color (0-15) 
set the clock hand color (0-15) 
select the red component (0-63) 
select the green component (0-63) 
select the blue component (0-63) 
Green, Blue) ' set the background color 


THEN 


set the clock hour mark color (0-15) 
set the clock hand color (0-15) 
select the background color (0-63) 
set the background color 


"CGA" THEN 


3 


set the clock hour mark color ( 0 - 3 ) 
set the clock hand color ( 0 - 3 ) 
select the background color (0-15) 
set the background color 


Next, you II add a subprogram that lets you change the VGA background color. 
Press Alt-E to display the Edit menu. Select the NEW SUB option A dialog box will 
appear Type the name of the new subprogram: 


Press Enter. QBasic wi 

l Sub SetRGB 

I END Sub 

Modify the first line of the s^ ^e;on. 

SUB SetkGb (Red, Green, B^e) 

Now add the following 

make sure END SUB appears as the last line 


IF Red > 63 THEN Red - 63 ' these lines check 

IF Red < 0 THEN Red = 0 1 the red, green and blue 

IF Green > 63 THEN Green = 63 1 color component values for 
IF Green < 0 THEN Green = 0 * out-of-range parameters 

IF Blue > 63 THEN Blue = 63 ' 

IF Blue < 0 THEN Blue = 0 
Bcolor& = 65536 * Blue + (256 * Green) + Red 
1 the line above calculates the combined RGB color value 
PALETTE 0, Bcolori ' sets the VGA background color 

END SUB 

Press Alt-V to display the View menu. Select QBCLOCK BAS (the main module) 
then press enter to reload the main module into the QBasic editor. Press Shift-F5 to 

fun the program 

You can experiment with new colors by changing the values of DrawWhite, 
OrawBright, and Background in appropriate IF THEN structures you ve added to 
QBCLOCK.BAS See Hint #1 to make the program changes necessary to view the 

modified program in all graphics modes 

—John Wolfskin 


two different colors, I’ll use the 
DrawHands subprogram for both op¬ 
erations. The TimeLoop subprogram 
calls DrawHands twice: once to tell 
it to draw the hands in white on a 
black background and the other time 
telling DrawHands to draw in black 
on the black background. The other 
adjustment is eliminating the 
WaitASecond subroutine; since this 
task is a single program line, I can 
incorporate it into the body of 
TimeLoop. The program outline now 
looks like this: 

Begin QBCLOCKBAS 

1. Call SetVideoType 

2. Call SetVideoParameters 

3. Call DrawBox 

4. Call TimeLoop 

a. Call DrawHands (White) 

b. Wait until the next second 
comes 

c. Call DrawHands (Black) 

End QBCLOCK.BAS 

Video Modes 

Now that I’ve created an outline, I 
can work on each subprogram indi¬ 
vidually. First up is SetVideoType, 
which assigns the variable Video- 
Tv peS one of four possible values: 
Text, CGA, EGA, or VGA. Because 
the program is modular, I needn’t 
worry what the main program does 
with the VideoTVpeS value after Im 
done with it. (In truth, SetVideoType 
is more properly known as a func¬ 
tion. which differs from a subpro¬ 
gram in that it can send a value to 
the main program.) 

But I have no direct way to ask 
QBasic the display type of a comput¬ 
er; the program must test all possi¬ 
bilities and see what works. Display 
modes in QBasic are tested through 
the SCREEN statement. SCREEN is 
a complex statement you can use in 
many ways; for this program, I use it 
only to set the display to one of three 
modes: 

For VGA screens, I must test the 
statement SCREEN 11, which puts 
the display into a 640- by 480-pixel 
display mode, which offers the high¬ 
est resolution for displaying the 


January 1993 


K 


Number 7 • DOS Resource Gu*cfc> 49 


















PROGRAMMING TUTORIAL 

clock. Unfortunately, if the computer lacks a VGA board, 
using SCREEN 11 causes a program error. 

• For EGA, I must test SCREEN 9, which sets the dis¬ 
play to 640- by 350-pixel mode. SCREEN 9 causes a 
program error unless the computer has an EGA or 
VGA board. 

• For CGA, I want SCREEN 1, which sets a 320- by 
200-pixel mode. (CGA also supports SCREEN 2, with 
640- by 200-pixel graphics, but a 320- by 200-pixel area 
gives us squarer, more attractive images.) If the com¬ 
puter doesn’t have CGA, EGA, or VGA capability, exe¬ 
cuting SCREEN 1 causes a program error. 

In these situations, a program error means a pro¬ 
gram crash. If a program executes a SCREEN state¬ 
ment with the wrong type of computer display, QBasic 
issues the admonition, “Illegal function call.*’ So, how 
can I test these SCREEN statements without crashing 
the program? 

QBasic’s ON ERROR statement comes to the rescue. 
This invaluable command lets you trap errors, includ¬ 
ing possibly invalid SCREEN modes, so you can take 
corrective action. I envision a proeedur» such as thi-: 


notated directories 

\ cv 



I frequently need to send floppy disks through the mail. I prefei to 
include an annotated directory on a separate sheet of paper so 
that the recipient knows what is on the disks. 

One solution is to use the DOS DIR command, press the Print 
Screen key, and scribble a handwritten note on the printout. The 
result is always messy. 

A better, and considerably neater, solution involves sending your 
screen's output to a file using a command such as this: 

DIR >B:FILES.TXT. 


• Turn on ON ERROR to watch for the intentional 
errors I am about to cause. 

• Assume the computer has VGA by executing 
SCREEN 11. If assumption is correct, no error will 

arise. 

• However, if an error does arise, assume EGA and 
execute SCREEN 9. 

• If EGA causes an error, assume CGA and execute 
SCREEN 1. 

• If CGA causes an error, assume the computer lacks 
graphics capability. 

• Once the video mode is set, turn off the ON ERROR 
system. 

The first line in the subroutine reads: 

ON ERROR GOTO VideoModeError 

This command sets up the ON ERROR watcher, spec¬ 
ifying that if a program error occurs, QBasic should 
jumj over to the part of the program labeled 
lodel 'r. >r. (The three statements composing the 
VideoMu .1 Error code are at the end of the main pro- 
{Bas’c limitation prohibits ON 
ERROR from jumping to statements 
within subroutines.) 

T1k mechanism I use for assuming a 
video mode is to assign text to the vari¬ 
able VideoTypeS. (The dollar sign indi¬ 
cates that VideoTypeS is a string vari¬ 
able, which means it can store letters 
and words. Without the dollar sign, 
VideoTVpe can store only numbers). I 
start by setting VideoTypeS equal to 
“VGA” (as in step 2 above) then execute 
the SCREEN 11 command. If the opera¬ 
tion works, VideoTVpeS remains equal 
to “VGA”. But if an error occurs because 
the computer doesn’t have VGA, control 
jumps to VideoModeError. That code 
looks like this: 



The greater than sign (>) “redirects” the output from the screen 
to the file specified. Then, with the help of a word processor or text 
editor, you can call up the file and annotate the directory listing to 
your heart’s content. Later, you can print the file from your word 
processor or DOS. 

DOS 5.0 users may want to use this command instead: 

DIR /ON /B >B:FILES.TXT 

The /ON switch tells DIR to sort the files alphabetically by name. 
The /B switch suppresses the normal directory header and footer, 
which makes the printed directory listing easier to read. 

—Robert J. Batterberry 


VideoModeError: 

VideoTypeS = 
RESUME NEXT 


•Text" 


These statements mean that if the 
SCREEN statement causes a program 
error, the program assumes the video 
system can display only text. The RE¬ 
SUME NEXT statement ends the error- 
handling routine and returns program 
control to the SetVideoType subpro¬ 
gram for the EGA test. If that fails, the 
program tests for CGA; if CGA fails, the 
program assumes the computer can’t 
display graphics. 
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Finally, because I'm through causing deliberate er¬ 
ror*. I turn off error trapping with the statement ON 
ERROR GOTO 0. Turning off error trapping when it 
isn't needed is a good practice; if something truly unex¬ 
pected happens, you want the program to crash so you 
can find and fix the problem. 

Bv the way, the entire SetVideoTVpe subprogram is 
what programmers call a kludge’, a clever trick de¬ 
signed to work around an unpleasant situation. It 
would lx? preferable if QBasic had a built-in facility for 
testing for display capabilities but, alas, it does not. 

Geometrical Progressions 

The second subroutine, SetVideoParameters, is one of 
the easiest. Using the VideoTVpeS value determined by 
SetVideoTVpe, it switches the computer display to its 
highest-resolution screen mode and sets variables to 
the screens maximum pixel width (VideoX) and height 
(VideoY). I prefer these names to VideoWidth and 
VideoHeight for two reasons: I’m less likely to mistype 
shorter names and, because I’m accustomed to drawing 
graphs using x and y axes, they should be easy to re¬ 
member. 

Another of the subroutine s variables is VideoAspect, 
the screen’s aspect ratio. Aspect ratio is a measurement 
of distortion that sometimes results because pixels 
aren’t always square. For example, on the EGA system 
I used to test this program, the monitor measures 10 
inches across; at 640 pixels, each pixel therefore mea¬ 
sures 0.0156 i: 

inches tall; at a vertical resolution of 350 pixels, each 
pixel is .0200 inches high If I tell QB.i \<- draw a l'-0- 
by 100-pixel “square.” it will actually m* asure 1 inch 

es wide by 2 inches tall. 

Later in the program. IT! apply ui asp. ; r.. e rec¬ 
tion by multiplying all veri \ a! ar \ c< ; i t i . v\- by 
VideoAspect. The basic formi t is is ,, low.- 

Physical height Pixel width 

VideoAspect = - 

Physical height Pixel width 

The SetVideoParameters subroutine uses my moni¬ 
tors physical measurements, 10 by 7 inches, to perform 
these calculations. On my EGA system, the formula is: 

7 inches 640 pixels 

VideoAspect = -*-- L28 

10 inches 350 pixels 

If the program doesn’t draw a near-perfect box 
around the clock, you can substitute the appropriate 
value for your display. Be sure to measure only the 
screen area in use. One way to do this is to run QBasic 
and measure the blue-and-white screen background. 
Substitute those values (in inches, millimeters, or 
whatever, as long as both the vertical and horizontal 


ZEICHICK’S BASIC RULES 
OF PROGRAMMING 

• To write complex programs, start by outlining what 
you want to do in manageable, bite-sized chunks You 
can worry about how to accomplish each part later 

• Keep refining that outline until each chunk is concep¬ 
tually simple and seems achievable Look tor duplicate 
steps you can implement using shared subroutines 

• Keep the main program simple; use it to define global 
variables, to string together the subroutine chunks, and 
to house your error-handling code 

• Use global variables sparingly, and only for constants 
Whenever possible, pass variables to subroutines; this 
makes the program easier to understand and to debug 


measurements use the same system) for the values 
currently assigned to ScreenX and ScreenY in 
QBCLOCK.BAS. 

Boxes and Ticks 

I’m ready to begin drawing the clock’s square outline 
and hourly tick marks. Note that because I’ve set the 
variables VideoX, VideoY, and VideoAspect, the pro¬ 
gram w'on’t need to deal with actual numbers for the 
screen’s width and height again. But I’ll continue using 
them to work through examples in this article. 

To make life easier, let me define a few “local” vari¬ 
ables inside the DrawBox subroutine. Local variables 
are temporary variables defined for use within a sub¬ 
rout i?t f r internal calculations; they can’t affect the 
ma:n program or ether subroutines. As a labor-savings 
device. Pi efine CenterX and CenterY as one-half of 
VuijoX and VideoY respectively—in other words, the 
coordinate <( enterX, CenterY) defines the very center 
of the screen. 

Another local variable is TickLength, defined as the 
distance (in pixels) from the screen’s center to the 12 
hourly tick marks. TickLength is set equal to 96 per¬ 
cent of CenterY; in other words, just under half the 
screen height. (Don’t look for special significance in that 
96-percent figure; I chose it after experimenting with 
other values.) 

Before continuing, let me introduce the LINE state¬ 
ment, which simply takes two points expressed in x,y 
coordinates (in pixels), and draws a line between them. 
The following statement, for example: 

LINE (10,20)- (30.40) 

draws a straight line between the pixel at position 
( 10,20) and the pixel at (30,40). 

Oh, I should tell you that screen pixels are counted 
from left to right and top to Ixittom: coordinate (0,0 ) in- 
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GETTING AN ANGLE ON CLOCK TICKS 

It the mere mention of the word trigonometry makes you feel 
tense and irritable try to relax Trigonometry is merely a 
means to an end, (getting the numbers you need to display 
the clock face), and remember Numbers are your friends For 
the moment, forget about aspect ratios and assume pixels are 
perfectly square Feeling better already 9 Good 

On page 51, I concluded that the clock's tick marks must 
be at a distance of 0 96 * CenterY pixels from the center of 
the screen, I therefore assigned that number to the TickLength 
variable. Using the EGA example. TickLength is equal to 
about 166 pixels 

The noon hourly tick mark should be centered horizontally 
but close to the top of the screen. The equation works out to 
coordinate (320.9) in EGA mode (CenterX CenterY - 
TickLength). Similarly, the 3 o’clock Lck is at (486,175) or 
(CenterX + TickLength, CenterY). 6 o’clock is (320. 341) 9 
o’clock is (154.175) 

What about the 1 o'clock tick? 1 hat - whr roe trig com:-: 
in. A circle has 360 degrees. rh 12 h i/ ‘:cks i ;t>e full 
circle, that’s 30 degrees per nek. As F<g .** shows t e tr..h > 
to calculate the horizontal ana ver cal :m ince I ' m 
ter. based on the angle the tick mart -w- 

Take a closer look at Fig. B w i :h 
My goal is determining the values of x. the hen/ vJ 
tance from the screen's center, and /. the veri' c- :/ -ce 
from the center, knowing two facts: the angle 1 : ! o’clock it’s 
30 degrees) and the hypotenuse (the length o‘ 1 LkLengir. 

The side labeled y, in right-triangle terms, c the adjacent 
side"; the side labeled x is the “opposite side." Now, I can use 
the basic trigonometric formulas 


sin(angle) = 


cos(angle) = 


opposite side 
hypotenuse 


adjacent side 
hypotenuse 


1 o'clock 


(CenterX,CenterY) 



Plf. A. Te pu p w fy Arw mi k 


Since I know the angle and the length of the hypotenuse, I 
can rewrite the equations as follows: 
opposite side (x) = hypotenuse * sin(angle) 
adjacent side (y) - hypotenuse * cos(angle) 

(Don't forget to offset the values of xand y by the coordi¬ 
nates of the screen's center). Substituting this program’s vari¬ 
ables. the general coordinate location of the hourly tick is: 
(CenterX + TickLength * SIN(Angle), CenterY - TickLength 
- COS(Angle)) 

where the angle starts at 0 degrees for 12 o’clock, 30 degrees 
for 1 o'clock, and so on. Let’s compute the actual coordinates 

for 1 o'clock: 

(320 + 166 * sin(30). 175 - 166 * cos(30)) = 

(320 +166 * 0.5,175 - 166 * 0.866) = 

(320 + 83.175 - 143) = 

(403.32) 

f ated wc 1 2 o’clock (320,9) and 3 

o’clock at (486175) 

: ti- s stiil seems cor.u - use a piece of graph paper 
pocket caic 1 ator n pl: |k the dox and hourly ticks 
;c. r-g ■/ ; jho w e ■ . ,ia T hcre’s nothing like working 
me numbeis manually to h. Ip you over the hump. 

. r-ni( r.gto e p- grameung stage. I must make two 
H ,.i ‘:*ents fn.iii.si applying me aspect-ratio correction 

)ther is converting 
^ before, are 1/360 

ol? • !e Your poet calculator probably performs its 

fr.gononr.etric calculations in degrees. 

Radians are an alternative measure there are two times pi 
radians in a Circle, or approximately 6.28 radians. (Each radi¬ 
an, therefore, is about 57 29 degrees.) QBasic uses radian 
measure for calculating sines and cosines; don’t ask me why. 
Therefore, I must add a conversion between degrees and radi¬ 
ans. I've defined another global variable, Radian, in the main 
program; I'll use it in DrawBox and DrawHands as a multiplier 
to convert degrees to radians wherever needed. 

—A.L.Z. 


y • 30 ° / 

! / i 

(CenterX,CenterY) 


Tlck«(CenterX ♦ Length, CenterY-Helght) 

y » TickLength * co*(30) 
x « TickLength * sln(30) 

(1 o'clock » 30-degree angle) 

L ° TickLength 
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dicates the top-left corner. That’s unlike the common 
Cartesian x K v coordinate system that you’re probably fa¬ 
miliar with, in which ( 0 . 0 ) indicates the 60 /tow-left cor¬ 
ner. The Figure, “Screen Coordinates,” shows the coordi¬ 
nates for the four comers and center of an EGA screen. 

A LINE statement should take care of the square box 
around the screen, but because of the aspect-ratio cor¬ 
rection. it’s not that simple. Working the following 
statement through, using a 640- by 350-pixel EGA dis¬ 
play and a 10- by 7-inch screen, shows whether this 
statement: 

LINE (CenterX - CenterY * VideoAspect, 1) - (CenterX 

♦ CenterY * VideoAspect, VideoY - 1), DrawWhite, B. 

really creates a square box. The DrawWhite clause 
means that the box should be in white. DrawWhite is a 
global variable, one defined in the main program and 
whose value is available for every subroutine’s use. It’s 
good programming practice, by the way, to use global 
variables only for “constants” whose meaning won’t 
change. The B clause merely tells LINE to draw a hol¬ 
low box using the two coordinates specified as opposite 
comers (instead of drawing a line connecting the two 
points). Tb create a filled box. use BF in place of B. 

Now, I’ll substitute EGA pixel values into the remain¬ 
der of the LINE command Under EGA, VideoX = 640, 
CenterX = 320, VideoY ~ 350, CenterY = 175, and 
VideoAspect = 1.28, so the formula looks like this 

LINE (320 - 175 * 1.28, 1) - (320 ♦ 173 * 1.J3, 

350 - 1) 

Because computer arithmetic always per' ir^ 

multiplication befon 

LINE (320 - 224, 1) - (320 + 224, 350 - 1) 

which yields the following: 



LINE (96. I) - (544, 349) 

This gives me the pixel coordinates of the comers arid 
tells me the box measures 448 (544-96 1 pixels horizon¬ 
tally by 348 (349-1) pixels vertically. When I convert 
those pixels to inches, using the numbers in the preced¬ 
ing section, I’ll know if I have a physical square: 

448 pixels* 0.0156 inches/pixel = 6.98 inches. 

348 pixels * 0.0200 inches/pixel = 6.96 inches. 

That’s close enough! 

The next task, calculating the position of the hourly 
tick marks, requires a foray into trigonometry. You can 
don your waders and follow me into the sidebar 
“Getting an Angle on Clock Ticks” or take it on faith 
that my ticks are properly articulated and move on to 
timing issues. 

No Time to Waste 

With the display type calculated, box drawn, and 
hourly tick marks computed and displayed. I’m ready 
to tackle the heart of the program: the TimeLoop sub¬ 
program, which draws and redraws the clock hands ev¬ 
ery second. 

TimeLoop follow's a simple procedure: 

Begin TimeLoop. 

1. As long as the user doesn’t press a key, repeat a-d. 

a. Find out what time it is. 

b Call DrawHands to create the hour, minute, and 
second indicators. 

c. Wait until it’s a new r second. 

d. Call Draw Hands to erase the indicators. 

fcrlt TimeLoop. 

Timelyeop receives certain variables from the main pro¬ 
gram—VideoX, VideoY, and VideoAspect, all of w'hich 
were calculated by SetVideoParameters. It’s important 
for the main program to explicitly send these variables 
to TimeLoop, so that TimeLoop can forward them to 
DrawHands (along with the current time and an indi¬ 
cation of whether DrawHands should draw* the hands 
in white or erase them by displaying them in black). 
QBasic, unlike GW-Basic, assumes that all variables 
are local unless you define them as otherwise (as I did 
with the global variables DrawWhite and Radian). This 
promotes good programming by stopping one subrou¬ 
tine from inadvertently damaging another subroutine’s 
variables. 

The near-infinite loop is handled by a WHILE... 
WEND pair, which keeps running through the cycle 
until INKEY$=“” no longer is true. INKEYS is a func¬ 
tion that finds out which key was pressed; as long as 
INKEYS equals nothing (two quotation marks with no 
space between them is QBasic shorthand for nothing). 
no key was pressed and the program can keep on dis¬ 
playing the clock. 
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The time-killing statement is another WHILE... 
WEND pair. It continuously compares the time shown 
on the computer screen (called NewTime$) with the 
computer's built-in clock, accessible through the QBasic 
function TIMES. As long as TIMES = NewTimeS, 
there's nothing to do but wait. Once they're different — 
because time marches on—the program exits the 
WHILE...WEND loop, uses DrawHands to erase the 
hour, minute, and second indicators, and begins the 
process anew. 


NewSecond - VAL(MID$(NewTimeJ,7,2) 

Similarly, you’d normally think that the minute is ex¬ 
tracted with VAL(MID$(NewTime$,4,2). However, a 
real clock’s minute hand moves a tiny distance every 
second; therefore, at 4:30:54, the minute hand shouldn't 
be positioned merely at the 30 minute tick (which is 
straight down) but actually nearly at the 31 minute 
mark: 30 minutes and 54 seconds. So, I chose to set 
NewMinute to 30 minutes, or 30.90 minutes: 


Too Much Hand Waving 

DrawHands is one of QBCLOCK.BAS’s most interest¬ 
ing functions; certainly, it’s the most math-intensive, 
applying the trigonometric principals from DrawBox 
with a vengeance. Fortunately, I’ve already figured out 
the key trig functions, which makes DrawHands pretty 
easy to implement. 

DrawHands has three tasks: 

• Drawing a small circle, at distance 0.9 * CenterY 
from the center of the screen, to indicate the -econds 

• Drawing a line of length 0.8 * CerterY to indicate the 

minutes 

• Drawing a line of length 0.6 * Cent rY to indicat: th n 

hours 

(As before, these lengths were chosen for aesthetic 
reasons >. The DrawColor variable , passed by TimeLoop, 
determines whether the program draws new r hands in 
white or erases old ones by drawing in black. 

After defining a few local constants and variables to 
simplify the math, the program translates the 
NewTime$ variable into a numeric format (from the 
character-string format—04:30:54—in which it is 
passed to DrawHands). That’s handled in two steps. The 
first uses the MID$ function to extract the appropriate 
characters. For example, since the seconds (54) are the 
two characters beginning at the seventh position from 
the left, they’re extracted as MID$(NewTime$,7,2). 
These are converted to QBasic’s numeric format before 
the program can use them in calculations; that’s accom¬ 
plished with another function, VAL, shown in this se¬ 
quence: 


HIDDEN, HIDDEN FILE 


If you run CHKDSK, you’ll see that it reports (at least) three hidden 
files. You may know that two of them are the required system files 
IO.SYS and MSDOS.SYS, but what’s the third one? It’s your 
volume label. 

—K.Y.N 


NewMinute = VAl(MID$ (NewTimeS, 4, 2) + NewSecond/60 

I apply the same principle to the hour. Instead of po¬ 
sitioning the hand squarely on 4 o’clock, I put it at 4 
hours and 30.90 minutes. Again, divide the number of 
minutes by 60 and add it to the hour to come up with 
the more exact value of 4.5150 hours: 

NewHour = VAL(MIDS (NewTimeS, 1, 2) + NewMinute/60 

Note to although the computer’s clock works on a 
24 I }\\ r * 1 ,t, i >i t' s clock it doesn’t matter whether 
the our is 4 5150 or 16.5150, trigonometric calcula¬ 
tion .*nsrre that the clock shows about half-past four. 

' 1 convert the seconds (54), minutes (30.90) and 

hours 4.5150) to a pair ofx,y coordinates, using a pro¬ 
cedure- identical to that used to compute the hourly tick 
marks: Convert the angle to radians, take the sine or 
cosine, multiple by the hand length, apply the aspect- 
ratio conversion (to the vertical coordinate only), and 
add or subtract from the screen’s center point. 

And you thought that displaying hour, minute, and 
second indications would be difficult. 

Time to Go 

I’ve covered the difficult parts of the programming; re¬ 
fer to the Program Listing to see how all the pieces fall 
into place. You can, of course, go one step further and 
type in and run the listing to see how the big clock will 
look on your computer screen. Although you may learn 
a few f things in the process, you’ll derive considerably 
more satisfaction from modifying the code to suit your 
needs or applying some of its techniques to programs of 
your own making. (You’ll find two 
“Tinkering Hints” on these pages sug¬ 
gesting two easy modifications.) QBasic 
is a nice, easy-to-use programming lan¬ 
guage; it’s much better than GW-Basic. 
So, if you’ve tried programming in GW- 
Basic and given up, perhaps it's time to 
try again. ■ 
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Prtgram ll»tlng. QRGIOCK.BAS Is a QBasIc program that displays a big analog clock In tha middle of your computer screen. You can alter H 
by following the Instructions In the Tinkering Hints on page 48. 

DECLARE SUB TimeLoop (VideoX!, VtdeoY!, VideoAspect') 

DECLARE SUB DrawHands (NewTimeJ. VideoX!, VtdeoY!. VideoAspect!, DrawColor!) 

DECLARE SUB DrawClockHands (VideoX!, VtdeoY!, VideoAspect!) 

DECLARE SUB DrawBox (VideoWidth!, VideoHeight!, VideoAspect!) 

DECLARE SUB SetVideoParameters (VideoTypeS, VideoWidth!, VideoHeight!, VideoAspect!) 

DECLARE SUB SetVideoType (VideoTypeJ) 

COHHON SHARED Radian, DrawBright, DrawWhite, DrawBlack 
• Analog Clock for QBasic 
' by Alan Zeichick copyright (c) 1986, 1992 
' This program may be freely given away, 

' but may not be sold without the author's 
' express written permission. 

Radian = 3.1415926535# / 180 

OrawBlack = 0 ’ Black (background color) 

DrawWhite = 7 ' Gray (hour markers) 

DrawBright = 15 ' White (base and clock hands) 

CALL SetVideoType(VideoType$) 

IF VideoTypeS = "Text" THEN 

PRINT "Sorry - this program only works on CGA, EGA, and VGA systems." 

END ' Stop the program, and return to DOS. 

END IF 

CALL SetVideoParameters(VideoTypeS, VideoX, VideoY, VideoAspect) 

CALL DrawBox(VideoX, VideoY, VideoAspect) 

CALL TimeLoop(VideoX, VideoY, VideoAspect) 

END 

VideoModeError: 

VideoTypeS * "Text' 

RESUME NEXT 

SUB DrawBox (VideoX, VideoY 'ideoAspect) 

CenterX = VideoX / 2 le horizontal screen center 

CenterY * VideoY / 2' ' The vertical screen ce iter 

TickLength = CenterY * ,96 ' Where the video ticks go 
LINE (CenterX - CenterY * VideoAspect, l)-(CenterX + CenterY * VideoAspect, VideoY - 1), DrawWhite, B 
FOR HourCounter - 0 TO 11 

TickX = CenterX + TickLength * VideoAspect * SIN(HourCounter * 30 * Radian) 

TickY = CenterY - TickLength * COS(HourCounter * 30 * Radian) 

LINE (TickX - 1, TickY - l)-(TickX + 1, TickY ♦ 1), DrawWhite, B 
NEXT HourCounter 

END SUB 

SUB DrawHands (NewTimeJ, VideoX, VideoY, VideoAspect, DrawColor) 

CenterX = VideoX / 2 ' The horizontal screen center 

CenterY = VideoY / 2 ' The vertical screen center 

HourLength = CenterY * .6 ' The length of the hour hand 
MinuteLength = CenterY * .8 ' The length of the minute hand 
SecondLength = CenterY * .9 ' The position of the second circle 
NewSecond * VAL(MIDJ(NewTime$, 7. 2)) 

NewMinute * VAL(MlD$(NewTime$, 4, 2)) + NewSecond / 60 

NewHour = VAL(HIDJ(NewTimeJ, 1. 2)) + NewMinute / 60 . 

SecondX - CenterX ♦ VideoAspect * SIN(NewSecond * 6 * Radian) SecondLength 
SecondY « CenterY - C 0 S(NewSecond * 6 * Radian) * SecondLengt 
CIRCLE (SecondX, SecondY), 4, DrawColor 
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MinuteX - CenterX + VideoAspect * SIN(NewMinute * 6 * Radian) * MinuteLength 



HinuteY * CenterY - C0S(NewMinute * 6 * Radian) * MinuteLength 
LINE (CenterX, CenterY)-(MinuteX, MinuteY), DrawColor 

HourX = CenterX ♦ VideoAspect * SIN(NewHour * 30 * Radian) * HourLength 
HourY s CenterY - COS(NewHour * 30 * Radian) * HourLength 
LINE (CenterX, CenterY)-(HourX, HourY), DrawColor 
ENO SUB 

SU6 SetVideoParameters (VideoTypeS, VideoX, VideoY, VideoAspect) 

ScreenX * 10 ' Your monitor's width, in inches or millimeters 
ScreenY = 7 ' Your monitor's height, in the same units as ScreenX 
SELECT CASE VideoTypeS 
CASE "CGA" 

SCREEN 1 
VideoX - 320 
VideoY « 200 
CASE "EGA" 

SCREEN 9 
VideoX * 640 
VideoY - 350 
CASE "VGA" 

SCREEN 12 
VideoX * 640 
VideoY * 480 
END SELECT 
CLS 

VideoAspect « (ScreenY / ScreenX) * (VideoX / V’de Yl 

END SUB 

SUB SetVideoType (VideoTypeS) 

ON ERROR GOTO VideoModeError 
VideoTypeS « "VGA" 

SCREEN 12 

IF VideoTypeS - "Text" THEN 
VideoTypeS - "EGA" 

SCREEN 9 

IF VideoTypeS * “Text" THEN 
VideoTypeS * "CGA" 

SCREEN 1 
END IF 
END IF 

ON ERROR GOTO 0 
END SUB 

SUB TimeLoop (VideoX, VideoY, VideoAspect) 

WHILE INKEYS - "" 

NewTimeS - TIMES 

CALL DrawHands(NewTimeS, VideoX, VideoY, VideoAspect, DrawBright) 
WHILE TIMES « NewTimeS: WEND 

CALL DrawHands(NewTimeS, VideoX, VideoY, VideoAspect, DrawBlack) 

WEND 



END SUB 


End 


— 
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Building a Solid 
Foundation 

The initialization module lays the groundwork for producing a sturdy program. 
Here are the tools you’ll need to begin constructing programs of your own. 


by John Wolfskill 


n nitialization is such an important building 
block of any program that it deserves more 
than the brief explanations I’ve given in 
parts I and II of this series. Although the 

other main pr< 
output- du tl 
the foundation, 
assumption- w 
In this instal 
< the initializat 

program, PPRIMER.BAS. These s 'ction letters refer 
to labels on the original listing. See Editor s Note be¬ 
low.) These sections set up internal variables and deter¬ 
mine how the program will handle data from outside 
sources. In addition, they prepare various devices for 
operation and establish the program’s error handler, 
which is a mechanism for making sure the program 
user’s missteps aren’t catastrophic. Along the way, I’ll 
explain how I handled initialization in PPRIMER.BAS 
and offer rules of thumb that you can apply to your own 
initialization sequences. 

If you’ve typed in the source code for PPRIMER.BAS, 
now is a good time to locate your hard-copy listing. You 


also may find it helpful to refer to the logic flowchart 
provided in Part II (see DOS Resource Guide #6, page 
63) as I discuss the program code. A third item you may 
want to keep handy is a QBasic or Quick Basic pro¬ 
gramming manual. 

Getting Started: Variables and Safety Nets 

The first line of the program (Section A in the listing) 
label - the beginning of the program initialization block. 
The block’s first command: 

DEF1NT A-Z 

tells QBasic to treat numeric variables as integers. 
Placing this line at the beginning of your program usu¬ 
ally speeds up operation. DEFINT tells QBasic to store 
and process variables as integers (whole numbers) 
rather than floating-point numbers (numbers with dec¬ 
imal points). By comparison, single-precision variables 
require twice as much storage space and considerably 
more processing time than integers. (See the chart 
“How to Use QBasic Variable Types" for more informa¬ 
tion.) Use DEFINT only to define a range of program 
variables that will handle w'hole numbers. 

The next, non-label line in the module: 

ON ERROR GOTO TESTERROR 


Editor's Note■ In DOS Resource Guide #5 1 page 58). we printed PPRIMER.BAS in its entirety. Limited space, however, 
precludes our publishing it again here. If you don 7 have that issue or issue #6, in which Part II of this scries was printed, 
you may order both for $5.95 each. Call 1-800-238-6580. 

To receive the program code, send us a formatted 5>U- or 3‘U-mch PC disk Is a self-addressed, postage-paid disk mailer 
IV, w ui copv ppiUMER BAS onto the disk and return it to you as soon as possible. Address your program requests to 
PPRIMEILBAS, DOS Resource Guide. 80 Elm St.. Peterborough. NH 03458. 
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HOW TO USE QBASIC VARIABLE TYPES 



Any whole number from 
-32,788 to 32,767 
Type-declaration character: % 

Example: NumberChi ldren \ - 4 


Every QBasic program can work with U a typr^ of nr. i , .y :n noldt r s chargeable 

data. Programmers need to tell QBas c t>hL\ ^rria^'e type LI be use\ The OFF i\ statement Is one 

way to do this: DEFINT (tor integer variables). DEFiflG ticrg nt*gf j), "tFf-KE (singta-uscfeion fluating 
point), OEFDBL (double-precision floating point), arid DEFSTF. (string) 

You also can use the phrases AS INTEGER. AS LONG, to define variable types. For example, “salaries AS 
INTEGER" would define salaries as an integer variable. The type-deciaratian characters shown here, 
which comprise a third means of declaring variables, have the added benefit of reminding you of a 

variable's type. 


DOUBLE-PRECISION 


Up to 15 digits 

(decimal can be in any position) 

Type-declaration character: # 
Example: Deficit# ■ 
3244084940762.83 


sets up PPRIMER’s error-handling routine. In plain 
words, the ON ERROR statement tells QBasic: When a 
program error occurs, don’t interrupt my user by dis¬ 
playing a system-error message. Instead, execute the 
code that begins at the line label Ive specified, and let 
me handle the errors in my own way. 

It’s a good idea to place an ON ERROR GOTO state¬ 
ment as close to the beginning of your program as pos¬ 
sible to ensure that all errors will be trapped. Also, re¬ 
member that QBasic will acknowledge only one ON 
ERROR statement at a time. If you include subsequent 
ON ERROR statements further along in your code, 
QBasic will regard only the most recent one as the ref¬ 
erence to your error-handling routine. 

By convention, error-handling code usually goes at 
the end of the program. The purpose of an error-han¬ 
dling routine is not to detect errors (QBasic does that 
for you) but to correct errors before they produce inac¬ 
curate results or “crash” your program. Let’s have a 
look at PPRIMER’s simple error handler: 

' (Z) - Error Handler - 
TESTERROR: 

S8 OOS Resource Guide • Number 7 


IF ERL = 9999 AND ERR = 53 THEN 
GOSUB SAVEFILE : RESUME LOADFILE 
END IF 

COLOR 7,0 : CLS : BEEP 

PRINT "Error ERR ; " in line ERL ; 

CLOSE 

END 

QBasic comes with built-in functions that automatical¬ 
ly update special SYSTEM variables after a program er¬ 
ror occurs. (SYSTEM is a QBasic keyword that termi¬ 
nates a program and removes it from memory.) Although 
these variables may lx? tested from within your program, 
only QBasic can change the values they contain. (For 
more information on PPRIMER’s error handler, see side- 
bar: “Messing Up On Purpose” on page 59.) 

QBasic updates the ERR and ERL system variables 
each time a program error occurs. ERR receives a refer¬ 
ence number that identifies the error (the number theo¬ 
retically can be between 1 and 255, although QBasic 
uses only some of the numbers in the range 1—76). 
ERL receives the number of the program line where 
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,l, t . error occurred. To determine the error, your pro¬ 
gram can test the value of ERR. For more specific infor¬ 
mation. however, your program should test ERL to de¬ 
termine the line number where the error occurred: 

If ERR * 27 THEN 

PRINT "The printer Is out of paper In line “;ERL: 

• add lines here to handle the error 
INPUT “Please load paper. Press <ENTER> to 

continue"; PS RESUME 

END IF 

You 11 find a complete listing of QBasic’s error codes in 
the appendix of your QBasic or Quick Basic program¬ 
ming book. Five types of QBasic errors exist, but here, 
we’ve been talking about only run-time errors—those 
that occur while you’re running the program. 

The third of Qbasic’s error-handling functions is set 
in motion by RESUME. This statement lets you specify 
where you want your program to resume exe¬ 
cution after the error-handler has tried to cor¬ 
rect the problem. RESUME has three forms: 
RESUME, RESUME NEXT, and RESUME 
line \ label, where the line number or label 
identifies the line at which execution should 
continue. 

The plain-vanilla RESUME statement lets 
you continue execution with the program 
statement that caused the error. Use this form 
only when you’re positive that the action.-* tak¬ 
en to correct the error will succeed; otherwisc 
your program may “hang” in an infinite « *ror- 
trapping loop. An example of this behavior ia 
program statement tha' at en.pts to open a 
disk file that doesn’t exist 

Use RESUME NEXT onh. when youYe sure 
the error is harmless for example, in a call to 
a printer subroutine: 


RESUME label lets you direct program flow to a 
“bail-out” area following an error. For example, suppose 
your program encounters a damaged disk when it at^ 
tempts to access a disk file. In this case, you’ll want to 
end the program quickly but gracefully. The following 
routine steers program flow to a predetermined exit 
routine: 

IF ERR - 72 THEN 

PRINT " An uncorrectable disk error has 
occurred." 

PRINT " Please check your disk drive, then 
restart the 

PRINT * program." 

RESUME QUIT 
END IF 

QUIT: 

END 


ON ERROR GOTO ERRTRAP 
GOSUB PRINTIT 
' the rest of the program 


END 

ERRTRAP: 

IF ERR = 24 THEN 

PRINT " The printer is off-line.." 

RESUME NEXT 
END IF 

In the example above, the error-handler 
simply informs the user that printing cannot 
^ke place, then it lets the program continue 
execution with the statement immediately fol¬ 
lowing the offending line. 
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' MESSING UP” ON PURPOSE 

It’s a tactic that may evoke cries of protest from programming 
purists But you can use QBasic’s error handling routines to do 
things that have nothing to do with errors. If you carefully examine 
PPRIMER BAS’s error-handling routine, you may notice that it ini¬ 
tially lets a program error occur. 

' (2) - Error Handler - 
TESTERROR: 

IF ERL - 9999 AND ERR = 53 THEN 
GOSUB SAVEFILE : RESUME LOAOFILE 
END IF 


Because ycu typed this program into your computer from the 
pages of a magazine instead of loading it from disk, the data file 
(PP.DAT) doesn't exist on your disk the first time you run the pro¬ 
gram. How, then, does PPRIMER manage to read data from a file 
that doesn’t exist on its maiden run? 

When QBasic encounters line 9999 in the LOADFILE subroutine, 
it dutifully puts error message 53 (“File not found”) into the system 
variable ERR However, an ON ERROR GOTO statement has been 
properly defined, so QBasic transfers control to the error handler 
instead of halting the program 

Upon receiving control, the error handler diverts program flow to 
SAVEFILE, a subroutine that handles the job ot writing PP.DAT to 
disk. Next, the error handler instructs QBasic to RESUME at the line 
that caused the error. Because PPDAT is now safely aboard your 
disk, the program proceeds without incident. 

I don't recommend making a practice of forcing QBasic to gener¬ 
ate errors But this example proves that you can use error-handling 
routines to solve sticky programming problems 

—J.W. 
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Keep String Arrays Untangled 

After using QBasic’s COLOR statement to initialize the 
video display in Section C, PPRIMER’s next task is to 
set up a number of string variables that will hold the 
printer-control strings, service the text-editor routine, 
and display prompt messages. Sections D-F provide 
these services. The following lines set up the arrays 
PPRIMER.BAS will need during operation: 


' (D) - Initialize string arrays and define strings - 

DIM ACT IONS(6 TO 17), C0NTR0L$(6 TO 17), 

MESSAGES(1 TO 5) 

QBasic’s DIM (Dimension) statement defines the AC- 
TION$() array to hold the text portion of the 12 control 
strings, and the CONTROL$() array to hold the actual 
data that will go to the printer. 

Arrays are collections of numbers or 
alphanumeric characters that can be 
stored and retrieved through indexing. 
The way in which QBasic indexes its 
arrays is no different than a card file 
that has dividers marked A-Z. Behind 
each categorical “index” card, you can 
store other cards with names that be¬ 
gin with the corresponding letter. 

There are many reasons for defining 
arrays from within your program: 
Arrays save programming time, in¬ 
crease execution speed, and conserve 
memory’. For example, you can initial¬ 
ize and print a series of simple ( non-ar¬ 
ray) strings, like this: 


(TTjIfind a file, any file 

With DOS 5.0, you can use DIR with its IS switch to tell DOS to 
search the current directory and all its subdirectories. So. to find a 
file whose name you know, you can go to the root directory and 

type: 

DIR filename /S 

If. for example, the file you want is called AUG , type the following 

from the root directory: 

DIR AUG /S 


DOS will present a list of each file named AUG that exists on 

your hard disk. 

If you’re not sure of the exact filename you can use wildcards 
For example, entering: 

dir au* /s 

will find all the files starting with AU, which might include a list as 
varied as AUGUST, AUGUST.TXT, AUG, and AUTO. DIR IS lists 
files that meet the criteria you specify, regardless of whether the 
file has an extension. 

You also can use the ATTRIB command to find a file. To use it 
instead of DIR to find a file named AUG.TXT, type: 

ATTRIB AUG.TXT /S 

The nice thing about using ATTRIB is that its listings are 
compact, displaying just the pathname and the filename, as in: 


SUNS » "Sunday" 

MONS = "Monday" 

TUE$ = "Tuesday" 

WEDS = "Wednesday" 

THUS = "Thursday" 

Although these strings appear to 
have a common theme (the names of 
days), no single element binds them. 
Notice that five program statements 
are required to print the complete set of 
strings on the video display: 

PRINT SUNS 
PRINT MONS 
PRINT TUES 
PRINT WEDS 
PRINT THUS 


C:\WP51\AUG.TXT 

C:\L0TUS\AUG.TXT 

If you use the DIR command, DOS shows each listing 
separately, as though it were providing a directory listing of each 
directory. 

If you think DIR will find numerous files meeting your search 
name, use ATTRIB to get a more compact listing. But to search for 
all files with a particular name, whether or not they have an 
extension, use DIR. 

—K.Y.N 


A better way to arrange most kinds of 
data is to dimension (DIM) an array to 
hold similar pieces of information. Each 
string in the array then becomes an 
ELEMENT of the whole. The num¬ 
bered array elements also allow pro¬ 
grams to manipulate the information 
quickly and efficiently. 

DIM DAY$(1 TO 5) 

DAY$(1) - "Sunday" 
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DAY$(2) - "Monday" 

DAYS(3) - "Tuesday" 

DAYS(4) » "Wednesday" 

DAYS(5) - "Thursday" 

Besides helping you arrange data more logically, ar¬ 
rays can make your program code more efficient. Note 
that you need only three program statements to print 
the DAY$0 array: 

FOR DAYS = 1 TO 5 
PRINT DAYS(DAYS) 

NEXT 

This short example doesn’t do justice to the efficiency 
advantages of array processing; the benefits multiply 
by leaps and bounds when you have hundreds of string 
elements in a sorting or printing routine. 

While writing PPRIMER.BAS, I needed to set up a 
pair of string arrays, each with sufficient space to hold 
12 variable-length strings. I accomplished this easily by 
adding the following statement: 

DIM CONTROLS(12) 

In many cases, however, this method may be ineffi¬ 
cient. By default, the DIM statement shown above re 
suits in an array that contain- 13 string elements 

(numbered 0-12 : 

an array, because it tends to com; icate developm* t • 

other program routines. 

A good exam pil¬ 
ing string arrays using QBasics string-handling func¬ 
tions (LEFTS, RIGHTS, MID$)| 

QBasic will generate an erro 
(“Illegal function call , if you 
attempt to manipulate the 
nonexistent zero position of a 
string: 

FOR J « 0 TO 11 

AS » MIDS (CONTROLS (J) ,J, 1) 

NEXT 

In most cases, you’ll find it 
easier to use QBasics optional 
DIM syntax, which lets you 
specify the lowest and highest 
elements of the array: 

DIM ACTIONS (6 TO 17), 

CONTROLS (6 TO 17) 

Using this form of DIM also 
allowed me to simplify the code 
of several PPRIMER routines, 
setting 6 as the lowest ele¬ 


ment of my string arrays, I was able to use a simplified 
routine to access and print the string elements on the 
video display. The first of the following similar routines, 
therefore, prints the strings faster than does the second 
one: 

FOR J «= 6 to 17 
PRINT J, 30: CONTROLS(J); 

NEXT 


FOR J = 1 to 12 
PRINT J ♦ 5, 30: CONTROLS(J); 

NEXT 

Files Made Easy 

Now that we’ve prepared PPRIMER’s string arrays for 
action, the next chore is to fill the elements with data. 
The LOADFILE subroutine, to which the main program 
branches in Section G, accomplishes this function. 

Earlier, I mentioned that PPRIMER creates the emp¬ 
ty data file PPDAT on its first run. In subsequent runs, 
however, this data file will contain the control strings 
you’ve saved from a previous work session. 

One of the simplest ways to load and save data for 
use with your programs is by creating a sequential data 
file. These data files store information as strings of 
ASCII text. Each element is separated from the preced¬ 
ing one by a carnage return or a comma. 

Before you can create a data file, you must open an 
input/output I/O' channel by requesting a DOS file 
number. DOS assigns file numbers to each active file 
(or device) as part of its internal housekeeping process. 



SING? E-KEY DELETES 


Here’s a simple trick that many new DOS users don’t discover until an 
experienced user lets them in on the secret. There’s no need to individually 
delete each file in a subdirectory prior to removing that subdirectory from 
your disk; you can delete the contents of an entire subdirectory with a 
single DEL (or ERASE) command. For instance, to delete all the files in a 
subdirectory named MYDIRECT, from the level above it. type: 

DEL MYDIRECT 

DOS responds with an “All files in directory will be deleted! Are you sure 
<Y/N>?” message. When you type Yand press Enter and then type: 

RD MYDIRECT 


the directory vanishes. 


J.w. 
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Your main program requests a DOS file number assign¬ 
ment when you issue QBasic’s OPEN statement: 

OPEN [file] FOR [mode] AS # [fllenum] 

In the following example, the LOADFILE subroutine 
asks to use an I/O channel by issuing the OPEN state¬ 
ment for file number 1. The OPEN statement also in- 



ALL IN A LINE 


If you issue a DIR command using the following DOS 5.0 syntax: 

DIR /0:N 

thinking you’ll get a nice alphabetical listing, you certainly will. But 
all your subdirectones will be mixed in with your files. As a result, 
you'll see a listing such as this one: 


forms QBasic that your program needs to receive infor¬ 
mation as INPUT. 

L0A0FILE: 


OPEN "PP.DAT" FOR INPUT AS #1 

FOR J = 6 TO 17 
INPUT # 1, CONTROLS(J) 

INPUT # 1, ACTIONS(J) 

NEXT 

CLOSE # 1 
RETURN 

The LOADFILE routine then sets up 
a FOR...NEXT counting structure to 
read information from the file. Each 
time the program executes INPUT #, 
two distinct actions occur. When QBasic 
reads the left portion of the statement: 

INPUT #1, 



<0IR> 

08-3J-92 

9-14a 

a single line of data is retrieved from 
the input storage buffer, an area in 


<DIR> 

08-31-92 

9:14a 

memory that DOS previously has filled 

FIG4-2 

TXT 

443 09-01-92 

8:14a 

wi-h information from the disk file. 

RPMSWAP 

TMP 2162688 03-31-92 

l:4lp 

QBasic next reads the right portion of 

VOODOO 

<DIR> 

08-31-92 

9:14a 

the statement: 

XENO 

<DIR> 
5 file(s) 

08-31-92 2:54p 

2162688 bytes 

CONTROLS(J) 


29317120 bytes free 

If the directory contains numerous files and subdirectories, all the 
subdirectories won’t appear on the screen at the same time. To get 
an alphabetical list of subdirectories followed by an alphabetical list 
of files use: 

dir /o 

This will produce a listing such as the following: 


to determine where to place the infor¬ 
mation. Each pass through the loop au¬ 
tomatically increases the value of J. 
When the loop counter becomes greater 
than 17, the FOR...NEXT loop termi¬ 
nates. Program execution then resumes 
with the statement that follows the 
NEXT keyword: 

CLOSE # 1 



<DIR> 

08-31-92 

9:14a 

which closes the I/O channel and frees 

., 

<DIR> 

08-31-92 

9:14a 

it for other devices to use. 

VOODOO 

<DIR> 

08-31-92 

9:14a 

I still have a lot of territory left to ex¬ 

XENO 

<DIR> 

08-31-92 

2:54p 

plore. In the next and final installment, 

FIG4-2 

TXT 

443 09-01-92 

8:14a 

I’ll look at SELECT CASE statements, 

RPMSWAP 

TMP 2162688 08-31-92 

1 :4 lp 

INKEYS, DO...LOOP, and WHILE... 


6 file(s) 

2163131 bytes 

WEND loop structures. I’ll also explain 


29315072 bytes free 

For those of you with many files and subdirectories, adding the 
IP to the DIR command will let you examine your alphabetized list 
a screen at a time. 

—K.Y.N. 


other functions that let your programs 
count, branch, and make decisions. • 

John Wolfskill is a free-lance writer t 
president of Powertrain Development, a 
software company, and a technical editor 
ofD OS Resource Guide. 
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Searching For 
The Ultimate Shell 


I f you’re sharper than the average DOS 
jockey, you’re probably tired of standing in 
the shadows cast by the spotlight on 
Windows. If you want, at the very least, to 
bask in a little of the glow these lights are 
throwing off, take a look at Symantec Corp.’s 
The Norton Desktop for DOS. 

The program gives DOS a versatile file 
manager and program launcher, as well as 
endowing it with a u drag and drop” style of 
Windows menus that lets you print, view, 
and copy files simply by clicking a mouse on 
a filename and dragging it. t > the appropriate 
icon. The former components are far more 
powerful than functions provided in DOS 
5.0’s shell. 

In fact, Desktop for DOS outdoes Norton’s 
own Desktop for Windows its predecessor— 
in several respects. First, the DOS version 
includes a host of great utilities, including 
built-in file compression and Norton’s Speed 
Disk optimizing program. And second, 
Desktop for DOS possesses three important 
virtues that are sadly lacking in most 
Windows products: speed, simplicity, and the 
ability to run on a system with only 640K of 
memory. Accordingly, Symantec is pitching 
the program to two main markets: Windows 
hashers and those who want to move to 
Windows but can’t afford the equipment. 

All of which makes the point that the com¬ 
petition for Desktop for DOS isn’t Windows— 
v pother DOS shells. And the competition is 
^och stiffer than Symantec might think. 
T^vidually, the pieces of Desktop for DOS 
nt »tack up well against competing pro¬ 


grams, but the collective breadth of its fea¬ 
tures will make The Desktop for DOS hard to 
ignore. 

Piece by Piece 

While Desktop for DOS has nearly all the 
file-management tools you’re 
likely to need, it is far from 
the being the best DOS file 
manager. The basic func¬ 
tions—copying, moving, 
and deleting files—are all 
there, and they can be ap¬ 
plied to entire directories 
as easily as to files. You 
also can split Desktop’s file 
panel to make room for a 
navigable directory tree, 
opening up a viewing pane 
underneath that displays 
the contents of any high¬ 
lighted filename. Desktop 
for DOS even lets you com¬ 
press and archive files us¬ 
ing PKZIP. 

But Desktop for DOS’s 
file manager isn’t quite as 
powerful as the likes of 
XTree Co.’s XTree Gold or 
even Norton’s own Com¬ 
mander, nor is it quite as 
easy to use. Unlike XTree, for example, 
Desktop doesn’t let you view the contents of 
zipped files without first unzipping them, 
which defeats the purpose a file viewer: let¬ 
ting you peek inside a file without opening 


Desktop for 
DOS outdoes 
Norton's own 
Desktop for 
Windows. 


BY PATRICK MARSHALL 
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the application that created it or the file itself. And 
even viewing the list of files contained in an archive 
takes more steps with Desktop than with XTree. 

Desktop, like a typical menu program, also 
launches your programs at the touch of a key or the 
click of a mouse, but it doesn’t do this any better 
than most menu programs. The program also scans 
your disk for applications it recognizes—100 of 
them, all told—and will generate its launch menu 
broken down into categories, such as word process¬ 
ing, entertainment, and spreadsheets. Unfortu¬ 
nately, Desktop frequently misidentified many of my 
more obscure programs. 

Finally, Symantec also maintains that Desktop for 
DOS is a task switcher and a memory manager, but 
it’s no more than adequate at these jobs. The pro¬ 
gram can’t, for example, run applications in win¬ 
dows, as Quarterdeck Office System’s DesqView can. 
Nor does it offer DesqView’s excellent expanded and 
extended memory management. 

The Whole Package 

Do I sound harsh? I don’t mean to. You shouldn’t 
write off Desktop for DOS as an “also ran,” just be¬ 
cause it comes in second place on the mqjor shell fea¬ 
tures. When you assemble the program’s many parts, 
you realize Desktop for DOS is jammed-packed. 
Considering the scope and depth of these features, 
you’ll be impressed by the program’s ease of use, 
which is far superior to that of competitive shells. 

The list of utilities Norton includes is impressive. 
In addition to FKZIP’s compression and archiving, 
Desktop for DOS includes Norton AntiVirus, Norton 
Backup (which includes support for tape drives), 
MCI Mail support, and Norton Disk Doctor (for diag¬ 
nosing and repairing disks). 

The latter module, one of the mainstays of 
Norton’s very popular utilities package, is joined by 
other familiar modules from that program: the 
Editor, a nifty set of screen blankers, Unerase, 
System Information, and Speed Disk (for optimizing 
hard drives). One of Desktop’s hidden gems is the 
Norton Batch Enhancer, which expands DOS’s batch 
language with conditional arguments, dialog boxes, 


PRODUCT INFORMATION 


The Norton Desktop for DOS 1.0, $179.95 

Symantec Corp. 

10201 Torre Ave 
Cupertino. CA 95014 
800-441-7234 
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Guide has a Reader Service Number 
(RS#) associated with it. 

To receive more information 
about a product: 

i i. Note the. number that 

appears in the advertisement. 

■L Circle the corresponding 
number on our postpaid card, 
opposite. 

3. Be sure to PRINT your name 
and address on the card, and 
mail the card today. 


am 
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Linda Guyette. Sales Representative 
(603)924-0130 or 
(800)441-4403 
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DOS SOFTWARE 


CREATING BATCH FILES WITH THE ENHANCER 


The whole point of Desktop for DOS is shiPirii™ 

imnrpssive wavs You can fnr pvamnin ° I\u S ?!? a 9 er e, 9 h t. commands that increase your batch tile options in 

ASKcommand 100,,erchoices 10theusef The BEEP coVomand 
SKS'IJnLSleYouranrp 9 l" 1 | c P 0 C n^ eaker - , ° alert users ,0 3,1 error mes sage or a request for a 
In ifpiav execution of a hatch (Up !„,!?* REBE)E)T command to restart your the computer or the TRIGGER command 
to delay execution of a batch file until a set time And the WINDOW and BOX commands let you create dialog 

Ltol^n^Il^pan rnmhhla l0n9 aS ^ ou lype 8fbefore a command and list the Desktop directory in your PATH 
statement y ° b,ne ,ts commands with ordinary DOS batch commands But you also can write script files 
entirely wit i Batch Enhancer commands, these programs execute more quickly than DOS’s batch files. 

shows how y° u m '9W create a simple batch file using both DOS's standard batch commands and 
Batch Enhancer commands (see the Program Listing). Its opening menu asks you to select the application you want 
to use. When you quit an application, the batch file instructs the computer to play a series of tones before returning 
you to the menu. Finally, when you exit the batch file, a box containing the message “Thanks for flying with us!” is 

displayed 

—P.M. 


Program Listing. MENU.BAT is a simple menuing program that uses both DOS’s standard batch commands 
and Batch Enhancer commands. 


§ECH0 OFF 

CD\ND 

BE ASK "Select a program: (X)Tree, (W)ord, (1)23, 

BE BEEP /G98 /D3 /R3 /W2 

or (Q)uit?" XW1Q 

MENU 

IF ERRORLEVEL 4 GOTO QUIT 

: 123 

IF ERRORLEVEL 3 GOTO 123 

CD\123 

IF ERRORLEVEL 2 GOTO WORD 

123 j 

IF ERRORLEVEL 1 GOTO XTREE 

CD\ND | 

:XTREE 

BE BEEP /C139 /D3 /R3 /W2 : 

CD\XTG0LD 

MENU 

XTGOLD 

: QUIT 

CD\ND 

BE BOX 10 10 20 40 RED ON BLUE 

BE BEEP /F440 /D3 /R3 /W2 

BE ROWCOL 15 12 "Thanks for flying with us!" 

MENU 

GREEN ON YELLOW 

:W0RD 

End 

CD\W0RD 


WORD 



and even images and sounds (see the sidebar, 
“Creating Batch Files with the Enhancer ). 

And Symantec’s not done yet. In addition 
to supplying an automatic timer (for setting 
U P scheduled operations, such as backups or 
executing hatch files), Symantec has thrown 
in several other “desktop” applications, in¬ 
cluding a calculator and a bare-bones ap- 
B M ment calendar. 

With this cavalcade of extras, Desktop for 
D OS bears some resemblance to Central 


Point’s PC Tools. But most users will find 
Desktop for DOS an easier package to use 
than PC Tbols. 

Is Desktop for DOS the ultimate DOS 
shell? No. But with a list price of $179.95. 
and a street price of around $100, it very well 
could qualify as the bargain of the year 
among DOS utilities. ■ 

Patrick Marshall is a contributing editor for 
InfoWorld magazine. 


January 1993 


Number 7 • DOS Resource Guide S5 






















A Little Voodoo Can Raise 
Windows from the Dead 

There’s no such thing as a “quick guide” to Windows setup, 
and here’s 35 reasons why: Windows Tips and Traps. 



by Kay Yarborough Nelson 


I ho Windows installation program is for the 
most part straightforward, but if anything 
goes wrong it goes very wrong—-you’re usu- 
I ally hung up and un¬ 
able to run Windows at all. Here's 
some installation help. 

First, decide whether you'll use 
the Express Setup or the Custom 
Setup. 

Use Custom Setup if you want 
to control the changes made to 
your AUTOEXEC.BAT and 
CONFIG.SYS files, or if you have 
only a certain amount of space 
available on your hard disk and 
want to install just some of the 
Windows components (see Tip 12, 

“Got a laptop?,” for suggestions 
about what not to install). A full 
installation of Windows 3.1 takes 
at least 10MB of hard disk space. 

Most folks find the Express 
Setup is just fine, even if they’re 



upgrading from Version 3.0 and it’s stored in a directory 
not named WINDOWS. Setup figures it out and even 
asks if you want to use a different directory name. 

But use Custom Setup if you’ve installed third-party 
device drivers (like those for special video displays) so 
you can tell Windows what you have. (See Tip 1, 
‘"Installation hung up?” for guidance.) If you’re not sure 
I of your setup, examine your system 
with a hidden utility. 

There’s a secret system diagnos¬ 
tic program called MSD < Microsoft 
Support Diagnostics) included 
with Windows 3.1 (at least it was 
secret to me, and it’s not in the 
manual’s index). It tells you what’s 
in your system as well as how 
you’re using memory, how many 
COM ports you have (and what’s 
on them), what your disk drive ca¬ 
pacities are and many other things 
you may not ever need to know, 
such as what your port addresses 
are. This wonderful tool is on Disk 
4 if you’re installing via 3.5-inch 
disks, or on Disk 5 of the 5.25-inch 
disks. You can run it from the flop* 
py disk (it s not compressed) or 


Editor ’# Note: This article is adapted from Chapter 8, *Oh, Hex!,* in Voodoo Windows by Kay Yarborough Nelson. 
Copyright 1992 by Ventana Press. Reprinted with permission. All rights reserved. 
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copy it onto your hard disk and then type MSD at the 
DOS prompt. Click on any of the items in the resulting 
screen to find out all about them, (see Figure 1). 

If you decide to do a custom installation, you may 
need to find out what’s really in your system, and MSD 
will do it for you. 

You can also use MSD’s File menu to examine your 
CONFIG.SYS, AUTOEXEC.BAT, WIN.INI and SYS- 

TEM.INI files. 

Once Windows is installed, use MSD to print out a 
copy of all your system information and keep it handy, 

just in case. 

If you’ve already installed Windows and want to run 
MSD, be sure to quit Windows first 

I Installation hung up? Try installing 
this way. First, do a Custom Setup— 
again, if you’ve already tried one. Two 
things may have happened. If you wore doing a Cu tom 
Setup, you may have picked the wrong harchvan If you 
were doing an Express Setuj Windows may not have 
detected your hard war correctly. If you tr. .1 Custom 
Setup (again), and it still doesn’t work, try tl»n. 

Use the command SETUP fl to run the elup pro¬ 
gram. This tells W 11 

Running Setup with 1 lets you tell Window - exactly 
what hardware you’ve got instead 
of letting it guess, which is the 
equivalent of choosing Custom 

Setup. 




that you’ve inserted a new disk. One cause of this is a 
disk cache. Are you running a disk-caching program like 
SMARTDrive? Check your CONFIG.SYS and AU¬ 
TOEXEC.BAT files if you’re not sure. If you are running 
a disk-caching program, edit the file to begin the line 
that runs the disk cache by adding REM to the line (as 
in REM device=smartdrv.sys). Then restart your com¬ 
puter and try installing Windows again. 

There could be one other thing ... If 

it’s not a disk cache that’s causing 
Windows to ignore your floppy disk 
drive, there’s one other brute-force thing you can try: 
add a DRIVPARM line to your CONFIG.SYS to make 
DOS recognize that drive. The line you’ll need depends 
on what you’re trying to do. 

• If you’re installing from drive A via a 5.25-inch 
1.2MB floppy, add this line: DRIVPARM =/D:0 /F:l 

• If you’re installing from drive A via a 3.5-inch 
1.44MB floppy, add this line: DRIVPARM=/D:0 /F:7 

• If you’re installing from drive B via a 3.5-inch 
1.44MB floppy, add this line: DRIVPARM =/D:l /F:7 

<» If you’re installing from somew r here else via some oth¬ 
er combination, get out the DOS manual and look up 
the DRIVPARM command. 


TIP 2 


What else can go 
wrong? Other 
sources of Setup 
problems are programs that are 
running in the background, such as 
a print job or a TSR (terminate-and- 
stay resident program) like a virus 
detection program or an erase re¬ 
covery utility. Make sure nothing 
else is running before you run 
Setup, and log off any network 
you’re on. 

Another weird thing that can 
happen during Setup is that Win¬ 
dows keeps asking you for the same 
disk, as though it’s not recognizing 



FIGURE 1: Use MSD magic to examine your system. 
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VOODOO WINDOWS 

Then take the problem disk out of the drive, restart 
your computer and see if that fixes the problem. 


again for the installation disk. Reenter the original 
drive letter and let the installation continue. 


TIP 4 


You can expand compressed files in¬ 
dividually. If you get a disk error mes¬ 
sage while you’re installing Windows, 
don’t panic. Try this voodoo technique to uncompress 
those compressed files manually. 

Use the EXPAND.EXE utility on Windows Disk 2 to 
uncompress any compressed files that aren’t installing 
correctly. First, copy EXPAND.EXE onto your hard 
disk, into the WINDOWS directory. Then change to 
that director and use it, giving the path to the com¬ 
pressed file and the path to where you want the ex¬ 
panded file to appear* (use its full name). For example, 
to expand WRITE.EX_ from a disk in drive A (com¬ 
pressed files have an underline as the last character in 
their extension ), you'd enter: 

EXPAND A:WRITE.EX_ C:\WINDOWS\WRITE.EXE 

Don’t do this unless you have to! Windows quite often 
needs to change your WIN.INI and SYSTEM INI files 
as you install components, and this brute-force installa¬ 
tion doesn’t get changes written into those files. 

If you get the disk error message before the graphic- 
based part of the installation comes up, expand the file 
and run the installation again. If you get a prompt to 
insert the disk that contains the problem file, enter the 
path to your WINDOWS directory on the hard drive. 
After Windows recognizes the file, it will prompt you 



TIP 5 




ORDER, ORDER! 


To maintain visual order in your DOS directory listings, add a place 
holder to sequentially numbered files. If, for example, you name 
ASCII text files to identify page numbers or book chapters, you can 
preserve the order in which the DOS DIR command displays them 
by adding a leading zero to all files below the number 10. For 
example, if you assign your files the names PAGE1 .TXT, 
PAGE2.TXT and PAGE10.TXT, the resulting directory listing may 
be hard to read: 

PAGE1.TXT 

PAGE10.TXT 

PAGE2.TXT 

Adding a leading zero, however, gives you the following display: 

PAGE01.TXT 

PAGE02.TXT 

PAGE10.TXT 


Read SETUP.TXT if you have any 

I TSRs. There are known conflicts with 
some terminate- and-stay-resident pro¬ 
grams and Windows 3.1. Read the file SL1UP.TXT to 
see which of these programs may cause problems and 
to find out what to do about them. To see that file fit’s 
on Windows Disk 1), even if you haven’t got Windows 
installed, give this command at the DOS prompt, as¬ 
suming Disk 1 is in drive A: 

TYPE A:SETUP.TXT | MORE 

Don’t know if you have any TSRs? Run MSD. 

Really bad setup problems? Use a se¬ 
cret switch before you make that toll call. 
Run Setup with the /L switch to force it 

to make a Jog of what’s happening. Then, when you call 

Microsoft, you’ll have a record. 

A faster way to upgrade and keep 
both Windows versions. If you want to 
keep Version 3.0 intact on your hard 

disk ami i stall Windows 3.1 as well, Microsoft 
recommend that you back up your Windows 3.0 files, 
upgrade to Vei*sion 3.1 and then reinstall your Windows 
programs I didn’t bother making a backup; I just in¬ 
stalled Version 3.1 into a different directory, and every¬ 
thing went just fine. I let Windows 3.1 
search the hard drive for programs and 
then rearranged them later into pro¬ 
gram groups in the Program Manager. 
It was a lot simpler than making a 
bunch of backups. 

This tip applies only if you’re preserv¬ 
ing the old version of Windows, which I 
see no reason to do now that Windows 
3.1 is final. 



TIP 8 


Don’t set up all your 
programs again if you’re 
upgrading and over¬ 
writing Version 3.0. If you’re upgrad¬ 
ing to Windows 3.1 from 3.0 (overwrit¬ 
ing Version 3.0), you’ve already got 
program groups set up with programs in 
them. If during installation you check 
the box that tells Windows to set up 
your applications again, you’ll have to 
delete the duplicate icons after Windows 
is done. 


-J.W. 
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I Create an INIs backup directory 

I j"i )V *-Q*P and * INI to a backup 

-* directory before installing Windows 3. ] 

Then, you always have a permanent copy of your cus¬ 
tom configuration to compare with. (You can always re¬ 
copy *GRP to the WINDOWS directory if your pains¬ 
takingly arranged former configuration gets lost.) 

I Keeping version 3.0 isn’t a great 
I idea. Don’t be timid about installing 
_ ■ Version 3.1 over Version 3.0. Problems 

that cause folks to go back to Version 3.0 haven’t been 
reported And you can cause problems by setting up a 
new Windows directory with a different name. Many of 
the programs you buy install their .INI and .DLL files 
into your WINDOWS directory and its SYSTEM subdi¬ 
rectory, so if you try running them from Windows 3.1— 
which you installed in a directory named, say, WIN31— 
your applications won’t be able to find their files. 

If you insist on having both versions stored on your 
hard disk, do it this way so you don’t cause problems. 
Copy your old WINDOWS directory and all its subdi¬ 
rectories to a new WIN30 directory. Then install 
Version 3.1 to overwrite your old WINDOWS directory, 
so that it will be the one named WINDOWS. (Use the 
File Manager or the DOS 5 Shell to rename the WIN¬ 
DOWS directory as WIN30, because plain old DOS 
won’t let you rename directories. 


Moving windows to another directo¬ 
ry. It’s not as easy as you may think! Use 
this foolproof voodoo so you don’t lose 

I anything, and so Window, can find you. Hies. 

First, create your new . 

rent directory is C:\WINDOWS and the new one is 
D:\NEWWIN. Use the DOS XCOPY command to copy 
all your Windows files and subdirectories to 
D:\NEWWIN (the /S switch copies all the subdirecto¬ 
ries of your WINDOWS directory): 

XCOPY C:\WIND0WS D:\NEWWIN /S 

After you copy the files, open WIN.INI in the Notepad 
and search for every instance of WINDOWS. Change 
those to the name of the new directory. Do this for all 
your .INI files (remember, you can search for INI in 
the File Manager). Then edit your AUTOEXEC .BAT 
and CONFIG.SYS files to change any lines that refer to 
C:\WINDOWS to refer to the new directory. 

It’s not over yet. In the Program Manager, check each 
item’s properties (highlight each icon and press 
Alt-fEnter) to make sure no WINDOWS references are 

in the Command Line box. Change any that you find to 

the new directory. 

When that’s done, use the PIF Editor to edit a 1 the 
WFs that refer to things that were stored in youi \ 
directory. 

January 1993 




Now reboot your computer and start Windows. Try 
launching a few applications. If you don’t get any error 
messages, its safe to delete your old WINDOWS direc¬ 
tory and its subdirectories. 

If you move Windows to a different directory on your 
hard disk, you’ll also need to change the path to your 
groups in the PROGMAN.INI file. Otherwise, Windows 
keeps on looking in the old directory for your .GRP files, 
and you’ll either get a message that Windows can’t find 
your groups or Windows will use the group configura¬ 
tions in the old directory—probably not what you want. 

Instead of recreating your groups in the new directo¬ 
ry, edit PROGMAN.INI to change their paths. Find the 
I Groups! section, and you’ll see lines like this: 

Groupl=C:\WINDOWS\MAINO.GRP 

If you’ve moved Windows to a directory named 
NEWWIN, you’d edit the lines to reflect the new path, 
like this: 


Groupl=C:\NEWWIN\MAINO.GRP 


TRAP 


I Take Windows 3.0 out of your path. If 

you choose to have both versions 3.0 and 
3.1 on your hard disk, even though 
Microsoft recommends against it, be sure that the path 
statement in your AUTOEXEC.BAT file reflects the 
path only to Windows 3.1. You’ll get a chance to edit it 
right there on the screen before you leave Setup if you 
do a custom installation. 


Switching between Windows ver¬ 
sions. Create hatch files to reset the 
path if you want to alternate between 
versions. For example, you can use batch files named 
T30.BAT (containing PATH=D:\W30) and P31.BAT 
(containing PATH=C:\WINDOWS) to alternate between 
versions 3.0 and 3.1. 



A hidden pitfall if you’re editing our 
AUTOEXEC.BAT in Setup. If you need 
to change any lines in your AUTO¬ 
EXEC.BAT file before leaving Setup, be careful about 
pressing Enter! Windows assumes that you’re ready to 
continue when you press Enter, and you may just be try¬ 
ing to insert a new line in your AUTOEXEC.BAT. This 
happened to me. You get a corrupted line (the one you 
were trying to edit) in your AUTOEXEC.BAT, and your 
computer won’t start right next time. If this happens to 
you, edit your AUTOEXEC.BAT file to fix that line be¬ 
fore you shut off your computer. The DOS 5 Editor is 
very handy for this. Enter E0IT at the DOS prompt, or 
use the Windows Notepad. 


TRAP 
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When Setup is done, you’re not. 
Set yourself up with a special dis¬ 
play driver for your laptop by using 
the Colors Control Panel and pick¬ 
ing one of the special laptop dis¬ 
plays—either an LCD or a plasma 
display, depending on what you 
own. You may also want to use the 
Mouse Control Panel and pick 
Mouse Trails so you can see the 
mouse pointer more clearly. 

Then go to the File Manager and 
see if there’s anything else you can 
live without. If you’ve used Windows 
before, you might want to delete the 
help (.HLP) files for the accessories 
you’ve installed and already know 
how to use. Read the README files 
(or print them out) and then clean 
them off your hard disk. 


Seeing what’s in your CONFIG.SYS 
and AUTOEXEC.BAT files. You’ll be 
seeing a lot of instructions in this article 
that say “Check your AUTOEXEC P,AT and CONFIG¬ 
.SYS,” or worse, “Edit your AUTOEXEC.BAT and 
CONFIG.SYS files.” To see what’s in them, enter CD\ to 
go to your root directory; then give the command TYPE 
AUTOEXEC.BAT or TYPE CONFIG.SYS. 

To edit them (outside Setup), first make a copy of 
them so you can get them back unchanged if anything 
goes wrong. Give this command at the DOS prompt: 

COPY AUTOEXEC.BAT AUTOEXEC.XXX 


TIP 11 


MORE SETUP TRICKS 


This makes a copy of your AUTOEXEC.BAT named 
AUTOEXEC.XXX. Do the same for CONFIG.SYS to 
make a copy named CONFIG.XXX. Now, if anything 
goes wrong, you can get the originals back by copying 
AUTOEXEC.XXX to AUTOEXEC.BAT and CONFIG- 
.XXX to CONFIG.SYS. Then, you can edit them with 
the DOS 5 Editor or the Notepad. 

To edit CONFIG.SYS with the DOS 5 Editor, give 
this command at the DOS prompt: Tb use the Notepad, 
choose Open from its File menu and enter: 

EDIT C:\CONFIG.SYS 


Got a laptop? Use these tricks. If you 
don’t want everything Windows has to of¬ 
fer because you just plain don’t have 
room for it on your laptop, do a Custom Setup. Then 
don't install the components you can live without, such 
as games, wallpapers, screen savers and accessories. 


TIP 12 


It’s not all over after you’ve installed Windows! You of¬ 
ten need to work a little more magic through Setup to 
install device drivers or to get out of “everything's hung 
up” situations. You can run Setup again through the 
Program Manager or at the DOS prompt, which you’ll 
need to do under certain conditions. 

When you upgrade to Windows 3.1, 
all of your device drivers may not be 
upgraded. If you’ve installed device 
drivers for additional components, like sound cards that 
weren’t provided with Windows, they’ll probably need to 
be upgraded to a Windows 3.1 version, because Setup 
doesn't change them. (But. hey! If it ain’t broke ...) 

Here’s one way to see if any drivers need updating. 
Your SYSTEM.INI file lists all your device drivers, and 
they’re probably stored in your C:\WTNDOWS\SYS- 
TEM directory. Go to the Kile Manager and choose 
Show All Details for your C:\WINDOWS\SYSTEM di¬ 
rectory (as well as any other directories that may be 
holding a driver) and check the dates of your driver 
files. Choose Sort by Date from the View menu to see 
the latest listed first. If the dates of your drivers are 
earlier than the date of your Windows release (the first 
release of Version 3.1 was 3/10/92), that may be the 
problem. Be on the lookout for files with the extensions 
DRV, .DLL and .FON—they’re the most likely to be 
overlooked. (Old .BMP files in your WINDOWS directo¬ 
ry are OK, but you may also want to check the WIN¬ 
DOWS directory to make sure all the accessories were 
updated.) 

Contact Microsoft (see the next tip) or the hardware 
manufacturer for updated drivers and, when you get 
them, replace the outdated drivers with new ones. 
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E ffjPi Don,t have the ri Kht device driver? 

Get a new one. Microsoft will give you 
the Windows Driver Library (WDL), 
which contains device drivers made available after the 
release of Version 3.1. If you have a modem, you can 
download WDL from networks such as CompuServe, 
OEnie and MS OnLine as well as from many electronic 
bulletin boards and from Microsoft’s special downloading 
service (206-637-9009). If you don’t have a modem, call 
Microsoft Customer Support Services (800-426-9400). 

The WDL may not have the driver you want, though. 
Tb be sure, call the devices manufacturer first. 


Exit from anything you’ve got run¬ 
ning before you use the Setup utility 
to change device drivers. If there’s 
anything running when you enter Setup, it may cause 
problems. Also, you’ll have to restart Windows after you 
use Setup to make the changes take effect, so make 
sure nothing else is “on” before you use Setup. 

Run the Setup utility from DOS to 
update your device drivers. You can 

run Windows Setup from within Win¬ 
dows (choose Change System Settings from its Options 
menu) or from the DOS prompt. It’s a little safer to run 
it from the DOS prompt because sometimes a new dri\ 
er may stop Windows from running correctly. 

Also, before you start installing a brand-new device, 
check to see if there’s anything else you’ll need to do to 
set up the device (get out the manual ). 

When you’re ready to start at f he DOS prompt, 
change to your WINDOWS directory, enter Setup and 
press Enter. Select the setting you want to change and 
press Enter. Scroll to the bottom of the list and choose 
Other (Requires disk provided by hardware manufac¬ 
turer), even if the driver you want to update is listed. 
You’ll be asked for the disk containing the driver. 



TRAP 


You can also use the Setup utility 
within Windows to install new de¬ 
vice drivers. When you start the Setup 
utility, you’ll see a screen like the one in Figure 2, which 
shows the settings for a 386. Choose Change System 
Settings from the Options menu. Then click the arrow 
to see the settings you can change; choose the one you 
want. You may be asked to insert one of the original 
Windows installation disks or the disk from your mouse 
or video card or keyboard manufacturer so that 
Windows can copy the right device driver. Then follow 
the instructions on the screen about restarting your 
computer or restarting Windows. 



trra ; 

■( 


■ Setup may balk if you install from a 
different disk size. The SETUP.INF in¬ 
formation file that tells Windows which 
^oppy disk each driver is on is different for 3.o inc i 


disks and 5.25-inch disks. So, if you originally installed 
Windows from 3.5-inch disks, use those disks again to 
install new device drivers, or you may be told to insert 
the wrong disk. 

Beware third-party OEM disks that assume you have 
one size disk or the other. If your third-party product 
thinks you installed from 3.5-inch disks and you’re real¬ 
ly using 5.25-inch disks, the OEMSETUPINF file may 
cause Windows to prompt you for the wrong installa¬ 
tion disk. In a pinch, you can try blindly inserting the 
Windows disk numbered one higher or one less than 
the prompt. 

What, all you’ve got is 5.25-inch disks? There’s voodoo 
to get around the problem. Copy the SETUP.INF file 
(it’s not compressed) from Disk 1 into your WIN- 
DOWSXSYSTEM directory, overwriting the SETUP¬ 
.INF file from the original installation. Now you can in¬ 
stall the drivers. 


TRAP 


Windows sometimes seems to ignore 
new device drivers. Here’s the sce¬ 
nario. You installed a device driver from 
its original equipment manufacturer (OEM) and every¬ 
thing worked just fine. Then you used Setup to change 
to a different driver and worked with it a while. When 
you wanted to go back to your OEM driver, Windows 
acted like it never heard of it, and you had to reinstall it 
What’s happening is that SETUP.INF doesn’t get up¬ 
dated when you install OEM drivers. If you never plan 
to switch drivers after you install them, you’ll have no 
problems, but if you want to switch back and forth be¬ 
tween the drivers Windows knows about and the OEM 
drivers you install, you can use a little voodoo. 

First, make a backup copy of SETUP.INF, just in 
case. It’s a good idea to keep it on a floppy disk with 
your other emergency just-in-case files like WIN.INI 
and SYSTEM.INI and your backup *.GRP files. 

Run Setup and install your new device driver. Then 
open OEMSETUPINF (it’s on the floppy disk with the 
drivers) in the Notepad and find the line for the OEM 
device you installed. Copy it and then edit the 
SETUP.INF file in your WINDOWSXSYSTEM directo¬ 
ry. Paste the new device driver line into the section 
where it belongs (usually the I display! section, if you've 
installed a fancy video monitor) and save SETUP.INF. 
Now that SETUP.INF knows about your OEM driver, 
you can switch to that device without having to rein¬ 
stall it after you switch to a different derice. 


Everything hung up? It may be a 
driver conflict. Sometimes you just 
might guess wrong about which derice 
driver to use while you’re updating your system, and as 
a result Windows hangs up and won’t run at all because 
of an internal conflict. Here’s how to recover. 

Quit Windows or restart your computer if every¬ 
thing’s hung up. Then run Setup from the DOS prompt 


TRAP 
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;vs described above, but pick the right driver this time. 

Ix>st a group? Make a copy of all your 
group files (copy *.GRP from your WIN¬ 
DOWS directory) and keep it handy on a 
floppy disk so you can get a group back if it disappears 
(strange things have been known to happen). 

Use a secret Setup switch to rebuild 
your groups. An undocumented (as far 
as I can tell) switch lets you use voodoo to 
rebuild your program groups if they mysteriously dis¬ 
appear from the Program Manager. Run SETUP /P 
from the Program Manager. 


TIP 16 


TRAP 


WHAT ELSE CAN 60 WRONG ? 


Just when you thought it was safe to inn your computer 
. . . other things can go wrong. Here’s a mixed bag of 
miscellaneous voodoo to help you recover from hidden 

pitfalls. 


Mouse won’t work? The most common 
reason is that it’s attached to COM3 or 
COM4. Windows won’t recognize a 
mouse attached to those ports. 

Mouse pointer jumping? 1 he simplest 
reason for this phenomenon is that its 
moving part (I hate to say ‘mouse ball’*) 
needs to be cleaned. The second most common reason is 
that you need to change its tracking speed in the Mouse 
Control Panel. If you’re getting something weird on the 
screen, you may have turned on Mouse Trails by mis¬ 
take. If it’s none of the above, it’s probably an interrupt, 
conflict between the mouse and something else in your 
system. Get out the mouse manual to see how to 
change its interrupt setting. 


TIP 18 


TIP 17 


disables that line. 

Another thing to do is check to see that mousein- 
Dosbox=l is set in SYSTEM.INI. If you installed 
Windows with no DOS mouse driver in your AUTOEX¬ 
EC.BAT or CONFIG.SYS files, it sets mouseinDosbox=0 
(disabling the mouse in small DOS windows). You need 
to use the DOS mouse driver supplied with Windows to 
make this work. It only installs itself if there was an old¬ 
er mouse driver in CONFIG.SYS or AUTOEXEC.BAT 
when you installed Windows. 


But some people prefer mouseinDosbox=0 so they can 
cut and paste to the Clipboard in the old 3.0 w r ay in¬ 
stead of using a “DOS” mouse in a window. 

If the mouse is working in Windows programs but not 
in non-Windows programs running in a window, the 
problem is probably that the mouse driver isn’t getting 
set up before Windows starts. Check your AUTOEX¬ 
EC.BAT to see if there's a MOUSE.COM line, or your 
CONFIG.SYS to see if there’s a MOUSE.SYS line (if 
you’re using a Microsoft mouse or one that’s compatible 
with it). 

Remember that the most up-to-date mouse drivers 
are in your WINDOWS directory, so the line in your 
CONFIG.SYS, for example, should read: 


DEVICE=C:\WINDOWS\MOU$E.SYS 


If ' u don’t find these drivers (maybe you didn’t have 
a mouse when you installed Windows), you can expand 
them from the installation disks. They’re named 
MOUSE.CO_ and MOUSE.SY_ (see Tip 4, “You can ex¬ 
pand compressed Hies individually”). 

The file manager can't read from 
your disk drive! If this happens, check 
your AUTOEXEC.BAT to see if GRAPH- 
ICS.COM is in it. The version ofGRAPHICS.COM that 
came with DOS 4 causes trouble. Upgrade to DOS 5 if 
you need GRAPHICS.COM. 



TIP 19 


IvOgitech And Microsoft mouse prob¬ 
lems. If you’re having problems with 
your Microsoft mouse, make sure you’re 
using either the MOUSE.COM driver (in your AU¬ 
TOEXEC.BAT) or the MOUSE.SYS driver (in your 
CONFIG.SYS) that came with Windows. They’re the 
latest drivers, stored in your WINDOWS directory. If 
you have a Logitech mouse, you should be using the 
LMOUSE.COM that came with Windows. 


TIP 20 


I Mouse won’t work outside of Win- 
jdows? Setup doesn’t set up the mouse to 
I work outside of Windows itself and some¬ 
times disables your mouse. If your mouse was working 
before and isn’t now, check your CONFIG.SYS and AU¬ 
TOEXEC.BAT files to see whether Setup began the line 
that previously enabled the mouse with REM. which 
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Everything’s slowing down! The most 
common cause here is lack of memory 
(your computer’s, not yours, although 
thats often a problem, too). You may notice your hard 
disk drive light on a lot, indicating that it’s swapping 
things around to make the best of what memory there is. 
There are a couple of things you can do, apart from buy¬ 
ing more RAM (which is an excellent idea, by the way). 

First, get out of as many programs as you can that 
you don t need. Turn ofT Wallpaper, if you’re using it. 
( heck to see if there’s a huge selection of graphics on the 
Clipboard and clear it. If everything is still slow, buy 
more RAM (or see Tip 32, “Getting more RAM without 
having to buy it,” later in this article). 
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I “Out of memory” 
I messages. There are 
_ I lots more things you 

can do to free up memory so that a 
program can run after you’ve re¬ 
ceived one of those annoying “Out 
of memory” messages. Here are a 
few (more or less in order of difficul¬ 
ty), assuming you’re running in 386 
Enhanced mode, and you’ve tried 
the tricks in the preceding tip: 



• Try running non-Windows pro¬ 
grams full screen instead of in a 
window'. Press Alt+Enter to switch 
from one to the other. 

• Check your AUTOEXEC.BAT and 
CONFIG.SYS and disable any TSRs 
that may be occupying memory. 

• If you’re running a non-Windows 
program when you get the message, 
edit its PIF so other programs won’t run in the back¬ 
ground. Here’s how r to do it w'hile the program’s run¬ 
ning. Open the Control menu (pressing Alt+Spacebar 
will do it); then choose Settings. In the dialog box that 
appears (see Figure 3), check Exclusive. Now nothing 
else will run in the background while you work with 
that program. 


Display Options - 
& W«doa 
O f U* Scieen 


fcneoiound [ 10U 
background fy) 


T asking Options 
□ E (elusive 
D Background 


FIGURE 3: Change a program to run exclusively to free more memory. 


If you’re still getting an out-of-memory message, you 
probably need more RAM, but try setting up a perma¬ 
nent swap file first. You can adjust the memory for a 
non-Windows program via memory via the PIF Editor. 
Check Text under Video Memory or tinker with the 
amount of memory wanted and needed by the program 
in the KB Required and KB Desired boxes (see Figure 
4). This is at best a trial-and-error 
process, and results depend on 
what you’re running. One word of 
warning: That KB Required 
amount is the smallest amount of 
memory the program can get by 
with, and the default setting of 
128K is usually not enough; most 
programs need 256K or more. 

Check your program’s documenta¬ 
tion and see if it specifies how much 
memory is really required to run. 


open any new windows, check the amount of system re¬ 
sources being used. Choose Help in the Program 
Manager and select About Program Manager. If you 
have less than 15 percent, you’re dead in the water. You 
won’t be able to open any more windows. Tb get out of 
this situation, close some of the windows. Then take a 
look at how many groups you have in the Program 
Manager. Try deleting a few groups that you hardly 
ever use. 


Getting out of a hangup. Sometimes 

I your programs mysteriously stall on you. 
I If this happens, press Ctrl+Alt+Del. It 
won’t restart your computer the way it used to. 
Windows lets you quit the program that’s causing the 



TRAP 


Using too many re¬ 
sources can slow 
you down. This was 
a big problem in Windows 3.0, and 
Version 3.1 has done a lot to allevi¬ 
ate it, but the problem can still come 
up. If you notice Windows perfor¬ 
mance slowing down or if you can’t 
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trouble and keep using Windows. 


change the FAT. This makes the backup copy useless. 


Hangups in non-Windows programs. 

You’re running a non- Windows program, 
and no matter what you do, your comput¬ 
er just beeps. Here’s an arcane secret. Check the Title 
bar to see if it says “Select” or “Mark” or “Scroll.” If it 
does, Windows has assumed that you want to select 
something or scroll through the file. Press Esc and see 
if you get control back. 

If pressing Esc doesn’t work, press Alt+Enter to 
make the program run in a window or full-screen, de¬ 
pending on what its doing now. If that doesn’t give con¬ 
trol back to you, press Ctrl+Alt+Del to quit the unruly 
program. 


TIP 24 


Start w ith a secret sw itch to trap 
boot errors. If you’re having trouble on 
startup, try starting Windows with WIN 
/B. This creates a file named BOOTLOG.TXT that in¬ 
dicates what went wrong. If you look at it, there should 
be a LoadFail line that shows where the problem oc¬ 
curred. Then call Microsoft Technical Support ( 206 - 637 - 
7098) and ask them to tell you what to do. 


TIP 25 


TRAP 


I Damaged group? Be sure to delete it 

1 If you get a “Group file error” message 
I saying that one of your groups is invalid 
or damaged and you need to recreate it, be sure to 
delete its .GRP file from the File Manager, as well as its 
group icon from the Program Manager, before you start 
recreating it. 


OPTIMIZING TIPS 


How’s your system using memory? By using memory 
wisely, you can optimize your Windows environment. 
Use the MSD program to check how memory is allocat¬ 
ed on your computer. Run MSD before you start 
Windows. 

If you’re an old DOS hand running DOS 4 or greater, 
there’s another way to see how your system is using 
memory: type MEM at the DOS prompt. But it can be con¬ 
fusing. 

On a computer that has 2MB of extended memory, 
you’ll see something like this: 


If weird things happen when you 
press a key . . . The most common 
cause is that you’ve assigned a shortcut 
key to the program, and it’s conflicting with a key com¬ 
bination that Windows uses. If it’s a Windows program, 
use the Program Manager’s File/Properties command 
to see if there’s a shortcut key assigned. If it’s a non- 
Windows program, use the PIF Editor to check its PIF 
for shortcut keys. 

Some DOS commands and programs 
don’t work with Windows. FAST- 
OPEN and APPEND cause problems un¬ 
der Windows. If by any chance they’re in your CONFIG¬ 
.SYS or AUTOEXEC.BAT, take them out. 

Here are a few other unruly DOS commands. The 
CHKDSK command, used with the /F switch, tries to 
alter part of your system that can’t be changed while 
Windows is running. UNDELETE also can’t figure out 
what’s what when you use it under Windows. Tb use ei¬ 
ther of these commands, exit from Windows first. 

Don’t try to optimize your disk with a commercial 
program while you’re running Windows, either (unless 
you use a special program like Norton Desktop for 
Windows, which is designed to do this). 

Don’t use DOS backup programs with Windows run¬ 
ning. DOS backup programs usually read what’s on the 
disk, which doesn’t sit well with Windows (which is, of 
course, using part of the disk for virtual memory). Also, 
if your backup program copies the FAT (File Allocation 
Table) while Windows is running, it’s quite possible 
that Windows will do something in the meantime to 
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655360 bytes total conventional memory 
655360 bytes available to MS-DOS 
617600 largest executable program size 
2097152 bytes total contiguous extended memory 
0 bytes available contiguous extended memory 
2031616 bytes available XMS memory 
MS-DOS resident in High Memory Area 

This means that you have 640K of conventional 
memory (655,360 divided by 1024) and 2MB (2048K) of 
extended memory (2,097,152 divided by 1024). (XMS 
memory is just another kind of extended memory.) So 
603K (you figure it out) is available for your pro¬ 
grams—it’s the “largest executable program size.” 

Now (and this is really a trap) if you saw a message 
like this: 

2097152 bytes total contiguous extended memory 
2097152 bytes available contiguous extended memory 

you’d think that everything was fine, wouldn’t you, be¬ 
cause the memory was “available”? You’d be wrong, be¬ 
cause “available” memory isn’t usable unless an extend¬ 
ed memory manager is controlling it. You want to see 
this line: 

0 bytes available contiguous extended memory 

It means all your extended memory is being used as 
XMS memory. If you’re not seeing this line, you’re not 
getting as much memory as you could, and the problem 
is probably in your CONFIG.SYS file. The lines: 
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DEV ICE*C:\WINDOWS\HIMEM.SYS 

dos=high,umb 


should come near the beginning of your CONFIG SYS 
hie, because they prepare DOS to use high memory and 
load DOS itself above 1MB. (See the next tip.) If you 
have a 386 computer, you should also see the line: 

DEVICES:\WIND0WS\EMM386.EXE NOEMS 

That NOEMS switch, which tells DOS not to use 
EMMJ8(>.EXE to emulate expanded memory, should 
usually be there, because if you’re using EMM386.EXE 
to emulate expanded memory, that memory isn’t avail¬ 
able to Windows. (See the next trap.) 

There are other switches you can use with the 
JflMEM.SYS device line that let you specify various 
things about it, such as specifically what kind of com¬ 
puter you’re using (if you’re using an Acer 1100, Wyse 
or IBM 7552), and so forth. Normally, you’ll never need 
to worry about them, but if you’re not getting all the 
memory that’s coming to you, or if you’re getting a cryp¬ 
tic message about the M A20 line,” check out HIMEM in 
the Windows manual for detailed tables about what 
you can specify. You have to be accurate about this, or 
you might damage your system, so I’m not going to tell 
you what to do here. 

Wateh out with NOEMS. If you use the 
NOEMS switch. Windows won’t provide 
internal expanded memory for Word¬ 
Perfect or other DOS programs that use it. Instead, you 
can set EMM386.EXE to reserve only a very small 
amount of external EMS (DEVICE-EMM386.EXE RAM 16). 
This takes only 16K away outside Window's and en¬ 
sures that dBASE. WordPerfect and the rest, running 
inside Window s, can have as much expanded memory 
as you want to give them. 

| You don’t have to load DOS high. 
Because of the way Windows takes con- 
Itrol of all the memory it can get hold of, 
you don’t have to load DOS high (as explained in the 
previous tip) if you only run Windows and Windows pro¬ 
grams. Just let Windows take care of memory for you. II 
you run non-Windows programs, though, loading DOS 
high gives you more memory. Loading DOS high won t 
hurt Windows users, but don’t turn yourself inside out if 
^8 not loading high. 

| Switches that tell more about memo¬ 
ry. You can enter MEM /C to see a detailed 

__J report of how' every program you ve got 

inning is being placed in conventional and uppei 
Memory. And if you’re even more interested, you can 
^EM /p (for program) or MEM /D (for debug' to gi t 
detailed listings. 
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TIP 29 


Using SMARTDrive. SMARTDrive is a 
disk-caching program that comes with 
Windows. Windows adds a SMARTDrive 


disk cache to your system during installation or adjusts 
the size of the one you may already have. Don’t confuse it 
wdth the swap file that’s also set up during installation. 
In your AUTOEXEC.BAT file, you’ll see two numbers 


at the end of the SMARTDrive line. The first is the size 


of SMARTDrive before Windows starts and the second 
is the size after it starts. When Windows starts, it 
switches to the smaller size so it can claim extended 
memory’ for its own applications. If you have 2MB of 
RAM, you should be using an InitCacheSize of 1MB 
(1024) and a WinCacheSize of 256K. With 4MB of 
RAM, the first figure should be 1024 (1MB) and the sec¬ 
ond 512. For up to 6MB of RAM, the first number 
should be 2048 (2MB) and the second 1024. Beyond 
6MB, you’ll need 2MB (2048) for each. Don’t be tempted 


to set up a SMARTDrive cache greater than 2MB, be¬ 
cause there’s not much improvement with a bigger 
cache, even if you have more RAM. 


TIP 30 


I Use fewer buffers and more files 
| w ith Windows 3.1. Windows 3.1 is set 
I to run with SMARTDrive, and SMART¬ 
Drive wants you to use only 10 buffers in your CON¬ 
FIG.SYS. Using a large number of buffers decreases 
SMARTDrive’s efficiency. Usually you’ll want FILES=30 
or more if you're running non-Window r s programs under 
Windows. 


TIP 31 


I RAM drive vs. SMARTDrive. Because 
SMARTDrive speeds things up as much 
or more than a RAM drive, you probably 
don’t need a RAM drive if you’re using Window’s with 
SMARTDrive. About the only time you might w’ant a 
RAM drive is if you have a large portion of RAM (say, 
SMB or so), and you’re using a program Like PageMaker 
that wants to use a large number of temporary files. 

Either one can speed up your system. But a disk 
cache like SMARTDrive is usually safer to use than a 
RAM disk, because what’s in R\M disappears when 
the power goes off. You can use both, if you like. Just re¬ 
member that each one does a slightly different thing. A 
disk cache works like a buffer, holding information 
about what you’ve done lately so that DOS doesn’t have 
to search your whole hard disk. A RAM disk is a super 
speedy “virtual” disk that works just like another drive. 


TIP 32 


|Getting more RAM without having 
■ to buy it. If you want the benefits of ad- 
___ Jditional HAM without having to purchase 
md install it, use a permanent swap file. Windows Will 
,se it temporarily to store data and programs that you're 
turning on your hard disk instead of storing it in RAM 
assuming you’re running in 386 Enhanced model 
First the background mumbo jumbo. If you do a 
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Custom Setup, and if your hardware can use 32-bit ac¬ 
cessing, when you install Windows it sets up a perma¬ 
nent swap file named SPART.PAR. < If you really want a 
bit of arcane voodoo, here it is: The actual swap file is a 
hidden file in your root directory, and you should leave 
it hidden.) If Windows can’t create the swap file, or if 
you’ve done an Express Setup, it creates a temporary 
swap file named WIN386.SWP that exists only when 
Windows is running and changes size as needed. 
However, to further confuse things, Windows wall cre¬ 
ate a permanent swap file if you’re upgrading from 
Window’s 3.0 and 3.1 finds a permanent swap file al¬ 
ready on your system. How can you tell what you’ve 
got? Go to the 386 Enhanced Control Panel and click 
the Virtual Memory button. Here’s where you see what 
kind of swap file you have. 

Normally, you’ll leave those settings alone, because 
they’re there as a result of Windows checking out your 
system to see how much memory you have, but you 
may want to change them, especially if you want to cre¬ 
ate a permanent swap file instead of a temporary one. 
(A permanent swap file is faster. ) Also, if you’re plan¬ 
ning to work with a program that you know requires a 
huge amount of memory, such as a graphics program 
with 256 colors, you might want to create a larger swap 
file than Windows recommends. Click the Change but¬ 
ton in the Virtual Memory box, and fill out the dialog 
box you’ll see (Figure 5). Press FI for more Help. 

When to go with no swap file at all. 

Windows 3.1 runs faster with no swap 
file at all, but if you don’t have one, 
Windows can’t use virtual memory. If you have 8MB or 
more of extended memory and you only want to run one 
or two programs at a time, you can get by with no swap 
file at all, and Windows will run very, very fast. 


If you run a lot of 
non-Windows pro¬ 
grams, you may 
want to specify device con¬ 
tention. Windows automatically re¬ 
solves conflicts when two or more 
Windows programs request access 
to the same device, such as a printer 
or a modem. If you habitually run 
several non-Windows programs at 
the same time, you may want to use 
the 386 Enhanced Control Panel to 
specify how they’ll get priority. 
Check Always Warn if you want to 
get a message every time there’s a 
conflict so you can decide which pro¬ 
gram gets to use that port. Check 
Idle and specify a number of seconds 
for the device to stay idle before an¬ 
other program can use it, such as 
when you use Cardfile to dial an in¬ 
formation utility like CompuServe and then want a non- 
Windows communications program to take over and ac¬ 
cess the utility. 

PIFs vs. .EXE files. If you double-click 

l * on an .EXE file in the File Manager and 
• . there’s a PIF for that program, Windows 

w ill use the settings in the PIF to run the program. If 
the program isn’t working as you think it should, this is 
probably what’s happening. 

When you run a non-Windows program, Windows 
looks first in that program’s directory to see if there’s a 
PIF for it. If it doesn’t find one, it looks in your WIN¬ 
DOWS directory. (If there’s no PIF for the program 
there, it uses the special .DEFAULT.PIF.) But instead 
of storing PIFs all over the place, why not keep them all 
in a directory of their own so you (and Windows) can 
find them easily? Just edit the Program Filename box 
to store your PIFs in a PIF directory. 

Can’t paste? Check out this tip. If you 

can’t paste into a non-Windows program, 
the problem might be that the program 
can’t accept Windows’ Fast Paste process, which is on by 
default. Check out the program’s PIF and see if Allow 
Fast Paste is checked. If it is, uncheck it and try pasting 
again. 

Also, remember that you can’t paste graphics from 
Windows to non-Windows programs. That might be the 
problem, too. ■ 

Kay Yarborough Nelson is the author of over a dozen 
computer books, including WordPerfect 5.1 Macro 
Handbook (Sybex). and The Little DOS 5 Book and The 
Little Windows Book (Peachpit Press). Voodoo DOS: Tips & 
Tricks with an Attitude was released in March. 
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READERS: To help you learn more about the many interesting products available lor your PC. 

DOS Resource Guide has created the DUG Marketplace This special section makes it easy to contact 
companies ottering a wide range ot accessories, software, and services. Listings are grouped by product 
category for your convenience. 


VENDORS: Listings in the DUG Marketplace ate sold by the column inch 
For more information, contact Linda Guyette at 1-800-441-4403 or 603-924-0130. 


ATTENTION 

HARDWARE 

VENDORS! 

Over the next 12 months. 

DOS Resource Guide 

readers will buy 

15,000 New PCs 
10,000 Monitors 
17,000 Printers 
14,000 Haid Drives 
11,000 Modems 

Shouldn't your product be 
advertised in DOS Resource 

Guide? 

1-800-44 1-4403 
or 603-924-013l> 

» 


Did you know... 

In the next 12 months, readers ot 

DOS Resource Guide w 

spend 

• more than $55 million 
on hardware 

• $22 million on software 

Call NOW ; or to reserve your 
space m the next issue of 

DOS Resource Guide! 

1-800-441-4403 
or 603-924-0130 


Software Vendors! 

DOS Resource Guide readers 

plan to buy more than 70,000 
software applications >n the 

next 12 months' 

Call today for information on 
how you can reach these 
DRG buyers' 

1-800-441-4403 
or 603-924-0130 
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SOFTWARE 


ENTERTAINMENT/GAMES 


BEAT THE LOTTERY 

38 Lotto Jackpot Winners WON 78.8 MILLION DOLLARS 
with Gail Howard's Systems! 

The ONLY Lottery System with Documented Jackpot Winners 

SMART LUCK* COMPUTER WHEEL'" fc 1 

$34.SO*S3$/H 

Has 2S2 Loco Systems With Speck W.n Gm anted Find One Sytterr 
That Farh Iti Win Guaanree and Y<x Get DOUBLE Your Money Back' 


m 


Gail Howard’s ALL NEW ADVANTAGE PLUS' 

Use ADVANTAGE PLUS'" and youH tosh all your other letter} joftware 
It's the mow complete, fastest and easiest to use-m a class by itself 
Nothing can befn to compare’ 

• NO OTHER SOFTWARE HAS MORE SUCCESSFUL 
SCIENTIFIC TOOLS FOR PICKING WINNERS 

• Includes AU Data (or- SO pick S and p*ck 6 Lotto Games FREE 

• Automatic SMART PICKS'* selects best Lotto Numbers mstanthr 

• Tw: Past Accuracy of SMART PICKS'" with One Key Stroke' 

• Has Over SO Socntik Charts/Rf ports to Zero -n on Wmnen 

• A S29S 00 Value Your ntroduetory pnee ior a 1 mned time ook 
S799S ^ S3 00 S/H (IBM'Cocr^ S 25 or 3 S) 
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Save 520’ Buy BOTH foe Only 199 9$ * S3 00 $/H 

man CO WITH A PROVEN WINNER] 

CALL I 800 876 -414S 

SMART LUCK* SOFTWARE 

Dept RS-I2.PO Bo* ISI9 • White Plains NT 10602 
1-800 876-GAIL (4245) or 914 761-2333 


C;r'k 125 ii» Haader Service Card 





your ad in 

Marketplace 
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you can start several or all of 
these 20 turnkey businesses part 
time and still retain the security 
of your present position Train 
tng and financing available 
To rectu* free cassettes 
and color literature, call: 

1*800-343*8014. Ext. 73 

(In Indiana: 3l7-7*A-441 M 

Bu«ine«» Seo ioe*. Inc 
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TAKE THE DREAD OUT OF DOS! 



If you’re trying to 
succeed with DOS, 
but feel like a 
General Failure... 

DOS RESOURCE GUIDE IS WRITTEN FOR YOU 


DOS RESOURCE GUIDE, the bi-monthly- 
periodical packed with tips, tutorials, and 
information on all aspects of PC computing, is 
your antidote for computing confusion. 

DOS RESOURCE GUIDE 

Make DOS Work for You 

Covers six areas of computing tiiat are vital to DOS users: 
start-up files (AUTOEXEC.BAT and CONFIG.SYS) batch 
file creation, hard drives, safe backups, organizing file 
management, and hardware maintenance. Includes: list m. 
a batch file that helps you keep appointments; 10 tips to kecr 
your hard drive healthy; speed-up tips for a logy hard drive; a 
batch file that automates backups; DOS shortcuts, hardware 
dos and don’ts. Plus 42 provocative pointers on DOS. 

DOS RESOURCE GUIDE #2 

Guide to Windows Software . i _ H 


DOS RESOURCE GUIDE #5 

The One-Stop DOS Primer 

/Ml you can eat: DOSKEY, SETVER. APPEND and ASSIGN, 
plus a tutorial on using the ATTRIB command. Part 1 of a 
Debug series. Our "10 Worst" list of DOS commands. Your 
introduction to serial ports. Includes a Qbasic Printer Control 
Program Just type and run. Sharpen your DOS finesse with 15 
type-in tips. 


-fCi RESOURCE GUIDE #6 

13 Ways to Boost Your DOS I.Q. 

Peter Norton shares some valuable COPY secrets. 
Personalizing the DOS 5 shell. Part II: altering disk data with 
DEBUG. Modem communications made simple. Meet the 
DOS competition—our first look at DR-DOS. 
Compression/decompression software explained. Part I of a 
batch file clinic; FREE for the typing: a QBasic name and 
address database. Plus, the lucky 13—tips, that is—for 
boosting your DOS I.Q. 


Back issues of DOS Resource Guide are $5.95* postpaid! 


DOS RESOURCE GUIDE #3 

The Essential Guide to DOS . ■ - r* 

S3(£)ili£> V i 

DOS RESOURCE GUIDE #4 

The Complete DOS Q&A 

Breaks DOS into functional sections: Fundamentals, Set-up. 
Improving Productivity, Memory Management, Hardware 
Upgrades, Batch Files, and Using Windows. Each section is 
followed by a question and answer session on the topic. Plus, 
seven short programs to protect your data; do-it-yourself 
memory, advice on CONFIG.SYS and AUTOEXEC.BAT, and 
beginner's Basic. Not to mention nine tips for the DOS timid. 


Use our 800 number and have your credit card ready! 

1-800-238-6580 

Or send your check or money order to: 

DOS Resource Guide 

P.O. Box 3162 
Salisbury, MD 21802 

•Maryland residents add 5% sales tax Back issues to Canada and Mexico 
cost $6 95 (Postpaid) Other International (Surface) $8 00 (Air) $13 00 
Checks and money orders musl be payable in U S funds, drawn on 
a U.S. bank 

VISA. Mastercard, or American Express also accepted Please include your 
card number, rts expiration date, and your signature on your request 

Please indicate which issue(s) of DOS Resource Guide you are ordering. 




ON’T MISS AN ISSUE! 






Now available to readers of DOS Resource from. 
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MaK9 every conpcting operalion smoother and 

make yoursell more productive when you employ Cruiser and the t4 
other utility orograms on this special disk Cruiser aitoers you to see 
nsrfe any file on your disk and page through it as if the disk were one 
arge bow Cruiser has a text editor, pop up calculator, and much 
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Return policy: All programs in origional 
packaging. Refunds only on product price. 
Call for Return Authorization Number. 
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Mail this order form to. 

Dev Wake Direct, 

12520 Kirkham Court, Suite 1-DR2 
Poway, CA 92064 

AH gjmes require 512K and DOS 2.2+ 
Please specify ilisk si 2 e (5.25" or 3.5 ‘). 


Shippinjt ChArfcrt 

l IS S% ol tot.tl ordrt (S^ numntumlH 

(. 4iudj 1 . . 1 t«»ul order (S6 minimum) V 

lorci^n 6*%. of total order ($1H rniniinum) J 
COP Jdd v- (L’s ordvrx only)P 
All payments in U S. funds only 
Tri . 1 -* -uh^t to change u tthout notice. 
JO-/>uv money bark guarantee 
on all products. 


SJame_ 

\ddress 
-ity — 


State 


country _ 

)ay Phone #( )_ 

Qty. Product ID/Name 



Unit Pi 


rice 


Total 


Method of 
Payment 

LlCheck/Money Order 
JV isa / MasterCard 
JDiscover 


7.75% Sales lax (CA Res. only). 

Shipping. 

Total, 


Credit Card# 


Expiration_/_Signature^ 


Order Toll-Free! (800) 879-0759 
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M*F -am-/pmP.ST Customer Ser\ r ice: 
Sat 9am-5pmPS.T. Fax your order to: 


■■ 

(619)679-2825 | 
(619) 679-28*7 




































































BUCK THE TREND! 
STAY WITH DOS 

RK S n2 t N ° W 3nd 9et 6 issues of D0S 

RESOURCE GUIDE for $23.70.*Save a buck an 
issue off the newsstand price! 


If you’re having trouble 
understanding DOS, stop 
worrying. It's not you! 


Understanding DOS is the key to 
effective PC-computing. But if 
you vc tried to learn DOS on your 
own wrestled with its manual, 
purchased a guidebook, or taken a 
course, you're probably still 
frustrated and confused. 


GUIDE, you'll find articles about 
using DOS commands, about 
managing your computer's 
memory; or maintaining order on 
your hard disk. 


Relax, you're not alone! 


Beginners will find step-by-step 
help at copying files, creating and 
removing directories, using DOS's 
wildcards to cut down on 
keystrokes, and practical advice on 
using DOS's many “switches" 
after each command. 


One estimate puts the number of 
DOS-run computers in the 
marketplace at 70 million. But 
how many DOS experts are there? 


Darn few, and here's why. 


Since late 1980, Microsoft Corp.’s 
DOS, the essential software 
ingredient of the IBM PC- 
compatible, has changed many 
times. Along the way, the 
operating system that began as 22 
cryptic commands has grown to 
about 100 equally cryptic 
commands, drivers, and 
programs. 


More advanced users will learn 
about batch files, which can 
provide capabilities that DOS 
forgot, or automate tedious 
activities, such as moving or 
backing up large groups of files. 
And you'll learn to use DOS 5's 
new QBasic programming 
language, and create macros at 
DOS's command line 


Each issue of DOS RESOURCE 
GUIDE is filled with tips on using 
DOS, undexumented shortcuts, 
and batch files you can type in and 
use. 


DOS RESOURCE GUIDE explores 
DOS's hidden secrets, untangles 
the twisted technical prose of 
manuals, and tells you in dear 
language how to use DOS. 

In each issue of DOS RESOURCE 


So, tap all of your computing 
potential by learning DOS, 
personal computing's most 
important—if not most popular— 
operating system. Order today! 
Use the coupon below; or call: 

800-238-6580 


YEST rM"BUCKING"THE"TREND! YESl I'M STAYING WITH DOS! 


lYES 1 Send me 6 Issues of DOS Resource Guide for $23.70.* 
- 11 Save me a buck an issue! 


NAME_ 

ADDRESS 
CITY 


CITY-- . . 

.. nrAor nr rrprlit Card-Payment must accompany your order) 
(Check, Money Order or Credit j MASTERCARD U DISCOVER 

□ AMEX LlVISA __ 

CREDIT CARD#. 


MU TO: DOS Resource ^^ (A)()$5370 
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Get the best of Windows and OS/2 
without learning all this. 



Sure, you want to get your PC flying. 
With features like multiple open applica¬ 
tions and background printing. Maybe 
even the ability to maintain your host con¬ 
nection while you work on something else. 

But for that you need Windows or 
OS/2. Which means you also need to 
leam enough to get a pilot s license. And 
spend enough on hardware and 
software for a down payment 
'J S onajet. 

® ut ncw Software Carousel, 
you can get the biggest benefits 
of Windows and OS/2 by doing 
almost nothing. 

It’s #1 in task switching 
software. 

Software Carousel got to be a best¬ 
seller because it works. Simply and 
reliably. Day in and day out. 

And because it gives you the single 
most practical and powerful function of 
OS/2 and Windows-the ability to quickly 
switch from one application to another. 

Simply load your programs as usual in 
individual Software Carousel work areas 
(it handles up to 12). Then switch 
instantly from one to another with just 
a keystroke. Each program gets as much 
RAM as it needs. And all your programs 
look and act just like they always did. 

Best of all, nearly any program that 
now runs on your PC will work with 


Software Carousel. Even RAM resident 
utilities, graphics programs and network 
software. And Software Carousel works 
on all types of PCs. So you can have the 
kind of multi-application capability you 
want, without buying anything new. 

Now with Print'N’Run. 

Thanks to Pnnt‘N’Run, new Software 
Carousel is also an advanced print handler. 
One that quickly takes over your printing 
jobs by accepting all the output bound for 
the printer, then sending it to the printer 
as fast as it can take it. 

While your printer keeps running, you 
can keep working in the same application. 
Or switch to another Software Carousel 
work area running a different application. 

No more wasted time 
waiting for your 
printer. No 
more lost 
productivity. 

OLE. A network 
idea whose time 
has come. 

OLE is the optional 
Open Link Extender* 
for Software Carousel. 


And it could be the best 





thing to happen to net¬ 
works since OS/2 itself. 

With OLE and Software 
Carousel, you can connect to 


any host or service over a network- 
whether it’s a mainframe, a mini, ctc- 
then “switch away” to work on another 
application, and not lose your connection. 

OLE even makes sure that incoming 
data is received, even though your PC may 
be occupied w ith another application.* 
And OLE works with all kinds of 
connection software. Including IBM, 
Attachmate, and others. Without 
changes to your hardware or software. 
Even the experts agree. 

Garry Ray, writing for PC Week, said, 
“Of these alternative operating environ¬ 
ments (OS/2, DesqView and Soft¬ 
ware Carousel), Carousel may be 
the best choice of the day.” 

Barry Simon of PC Magazine 
concurred with, "... I find it 
difficult to imagine using my 
computer without Carousel. 
This package has become 
an essential tool and one 
that 1 strongly 
recommend.” 

So if you really want 
the major benefits of 
«n Windows and OS/2, 

don’t get grounded 
with high cost and 
mind-bending complexity. 

Take off today with Software 
Carousel. It’s easy. And it’s just $89.95. 


#Car! 


Software, 


rousel $ 89 95 

ScitLogic Solutions, Inc. 

One Perimeter Road, Manchester, NH 03103 


Available at software dealers everywhere. 
Or, order direct by calling toll-free. 

Call 800-272-9900 

(60J-627-9900 in NH) 


SorrLcxac 

SOLUTIONS 


< ***a»r (**awl (. ( H*n 1 ml Entndrr (Vnt N Rim Jtr trafcawht>« npurtnl tmlrmnlkiNAI .«k Viirfrrfn Othtr hnnd fu 
•< )pcn Link L* tender t* aold separately. tRet|uire* NetBIOS connection 


nwindnMilii) A (npntm .«nrrv © fWSLS 

Circle 105 on Reader Service Card 


i 







